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Formation Web Services Sage X3 


i. Presentation 

1.1. Generalites sur les services web 

1.2. Les services web Sage X3 

1.3. Les Methodes des services web Sage X3 

1.3.1. Le Service Web Objet 

1.3.2. Le Service Web Sous programme 

1.3.3. Le Service Web Liste 

1.3.4. La Methode GetDescription 




1.1 Generalites sur les services web 


■ Qu'est-ce qu'un service web ? 

• Un service web est une technologie qui permet a une application de 
s'ouvrir vers I'exterieur pour proposer des fonctionnalites a d'autres 
applications, en dialoguant a distance via Internet. Ceci, 
independamment des plates-formes et des langages sur lesquelles elles 
reposent. 

• Chaque service web propose un ensemble de fonctionnalites (leur savoir 
faire) appele methodes. 

• Les services Web s'appuient sur un ensemble de protocoles (SOAP : 
Single Object Access Protocol) standardisant les echanges. 

• La technologie des Services Web englobe de nombreux concepts et tend 
a s'imposer comme le nouveau standard en terme d'integration et 
d'echanges B2B et B2C. 
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1.2 Les services web Sage X3 


■ Les services web adonix reposent sur des standards definis et non sur un 
protocole proprietaire, Ils permettent la communication entre X3 et 
d'autres applications. 


■ Ces applications peuvent couvrir de nombreux domaines : 

- Site Internet E-Commerce B2B/B2C 

- Application metier 


■ Chacune des ces applications ont des points communs : 

- Un fort besoin d'interactivite avec I'ERP : 

s Mise a disposition d'informations « up to date » 
s Mise a jour de I'ERP en temps reel 

- Une securite accrue 

s Pas de fichier ASCII transitant sur des disques durs 
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1.3 Methodes des services web ADONIX 


■ X3 propose un web service qui regroupe les methodes 
suivantes : 


1. Methodes des Objets : permet d'acceder a X3 via les objets 
«metier» du progiciel. 

2. Methodes des Sous Programmes : permet I'execution de 
programmes developpes dans X3. 

3. Methodes des listes : permet la consultation d'informations 
basees sur le parametrage des objets «metier», liste gauche 
des objets sage X3. 
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1.3.1 Le Service Web Objet / Description 


■ Les methodes des Objets permettent d'acceder aux objets 
« metier » du progiciel. Tels que : 

v' Commandes de ventes 
s Articles 
^ Clients 

s ... Tout objet X3 est eligible 

- Seuls les objets lies aux cycles de vente sont certifies par 
Sage ( commandes, articles, clients ) 

- Les methodes lies aux objets peuvent etre appliquees a 
n'importe quel objet, elles restent figees meme si I'objet 
evolue ( patch, changement de version ... ) 
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1.3.1 Le Service Web Objet / Methodes 


1. Lecture d'enregistrements : Read(contexte, objet, cle) 

s On demande a X3 de lire un enregistrement, on donne la ou les 
valeurs de cle. Cela revient a consulter une fiche dans une gestion 
objet, I'enregistrement n'est cependant pas verrouille. 

s X3 nous repond en nous donnant les valeurs de I'ensemble des 
champs des ecrans de I'objet concerne. 

2. Creation d'enregistrements : save(objet,flux) 

s On demande a X3 de creer un enregistrement, on lui transmet 
tous les champs necessaires ainsi que ceux rendus obligatoires 
dans les ecrans. L'ensemble des controles applicatifs sont 
declenches. C'est I'equivalent du bouton creer de la gestion objet. 

s X3 nous repond en nous donnant la valeurs de tous les champs 
des ecrans et les messages d'erreurs eventuels, on sait si la 
creation a ete effectuee ou non. 
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1.3.1 Le Service Web Objet / Methodes 


3. Suppression d'enregistrements : delete(objet,cle) 

s On demande a X3 de supprimer un enregistrement, on lui transmet 
les valeurs de cles. L'ensemble des controles applicatifs est 
declenche. C'est I'equivalent du bouton supprimer de la gestion objet 

s X3 nous repond en nous donnant les messages d'erreurs eventuels, 
on sait si la suppression a ete effectuee ou non. 

4. Mise a jour d'enregistrements : modify(objet,cle,flux) 

s On transmet a X3 les valeurs de cle ainsi que les champs devant etre 
mis a jour. 

^ X3 effectue la mise a jour nous repond en nous donnant les 

messages d'erreurs eventuels. Les tables annexes sont mise a jours. 
C'est I'equivalent du bouton enregistrer de la gestion objet. 


9 © 2006/2007 Sage - Midsize And Large Businesses 





1.3.1 Le Service Web Qbjet / Methodes 


3. Execution d'option : actionObject(objet,option,flux) 

s On va demander a X3 d'effectuer une fonction liee a un menu ou un 
bouton ajoute a un objet. Par ce biais on peut executer une tache 
particuliere comme valoriser la commande sans la creer. 

s X3 nous repond en nous donnant le contenu de chaque champ de 
I'ecran de I'objet concerne. 
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1.3.2 Le Service Web Sous Programme 


■ Les methodes des Sous Programmes permettent d'executer des 
traitements L4G 

s Demander un prix 
s Obtenir la photo d'un produit 
s Interroger le stock 
s Mettre a jour des reservations client ... 

^ ... Tout sous programme X3 est eligible 

■ Une fois la description du sous programme enregistre dans le dictionnaire 
X3, celui - ci peut etre declenche dans X3 par le web service. 



Le sous programme ne doit pas necessiter ('intervention de 
I'utilisateur pour s'executer. II doit etre autonome avec les 
parametres transmis lors de son appel. 
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1.3.2 Le Service Web Sous Programme 


■ Pour executer un sous programme il faut utiliser la methode 

runXml(code du sous programme, flux des parametres). 


■ Exemple sur une demande de tarif.On demande a X3 d'executer le sous 
programme « TARIF » en transmettant le code de I'article, le code du 
client, 

s X3 nous repond en nous transmettant tous les parametres du sous 
programme decrits dans le dictionnaire : code de I'article, code du 
client et enfin le prix. 

s II ne reste plus qu'a exploiter decoder ce prix dans I'application 
cliente pour I'utiliser 
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1.3.3 Le Service Web Liste 


■ Les methodes des Listes permettent la consultation d'informations 
basees sur le parametrage des listes gauches. 

■ Exemple ; 

s Demander la liste des commandes d'un client 
s Demander la liste des articles d'une categorie donnee 


■ Toutes les listes gauches des objets peuvent etre interrogees par ce 
service web. 


■ Les criteres utilises pour construire le filtre sont cependant limites aux 
colonnes presentes dans le parametrage de la liste gauche. 


La liste interrogee est la liste principale de I'objet, les autres tiroirs ne sont 
pas disponibles. 
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1.3.3 Le Service Web Liste 


■ Pour interroger une liste le service WEB propose la methode 

Query (objet,cle,nombre de lignes). 

Celle-ci interroge la liste gauche d'un objet dans X3. 


■ Exemple sur la liste gauche des articles : 

s On demande a X3 de nous donner le contenu de la liste gauche de 
I'objet des articles. On lui transmet les criteres d'interrogation de 
cette liste : 

• Article commengant par L : L* 

• De la categorie « fragile » : FRL 

s X3 nous repond en nous transmettant un tableau avec toutes les 
colonnes parametrees dans la liste gauche dont les lignes 
correspondent aux criteres demandes. 
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1.3.4 La Methode GetDescription 


line methode permettant de verifier la disponibilite d'un service : 

Cette methode commune permet : 

s De verifier si un objet, une liste ou un programme a ete publie en 
mode WEB Service. 

s De recharger la derniere version de la publication dans le cache d 
serveur WEB 

s D'obtenir un certains nombre d'information : 

• Pour une liste : les noms et type des colonnes 

• Pour un objet : les noms et type des champs des ecrans 

• Pour un sous programme : les noms et type des parametres 
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En resume 


■ Si I'on desire gerer des enregistrements dans X3, en tenant compte des 
regies de gestion et des controles applicants, 

- L'utilisation du service web objet est tout a fait indique. 

- La contrainte essentielle est bien entendu que I'objet existe dans X3 
et que celui-ci n'ouvre pas de fenetre complementaires. 

- Aucun developpement n'est a priori necessaire dans X3, seule la 
conformite de I'objet est a verifier dans ce mode d'exploitation. 


■ Si I'on desire consulter des listes en tenant compte des restrictions 
liees au parametrage des habilitations utilisateurs et des roles 

- L'utilisation du service web liste est une des solutions possibles 
mais, les informations devant etre consultees par I'application tierce 
doivent etre parametrees dans prealablement dans X3 dans une 
liste gauche. 

- Un nouvel objet peut cependant etre cree uniquement pour sa liste 
gauche 
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En resume ... 


■ Si I'on desire executer des taches particulieres n'etant pas disponibles 
sous la forme d'objet dans X3 

- Le service web sous-programme est le seul permettant de 
repondre cette demande. 

- La contrainte principale est que le sous programme doit etre 
autonome (pas d'interaction avec I'utilisateur) 


- Et bien entendu qu'il soit decrit dans le dictionnaire X3 
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Formation Web Services Adonix 


2. Principe de fonctionnement 

2.1. Notion sur les solutions Sage X3 

2.2. Zoom sur le serveur WEB 

2.3. Traitement d'une requete web / service 

2.4. Fonctionnement du pool de connexion 




2. 


Notion de solution Sage X3 


■ Une installation Sage X3 comprend un et un seul dossier mere et n dossiers fils 
qui heritent des elements definis dans les dossiers de niveau superieur selon les 
regies de propagation sage X3. 

s Chaque dossier de I'arborescence possede des tables dans la base de donnees 
et un ensemble de repertoires sur disque. II est possible de localiser les 
elements sur disque sous differentes racines en utilisant le concept 

d'adxvolume. 

^Pour chaque installation le nom de dossier est discriminant, mais il est 
possible d'avoir sur la meme machine (ou sur des machines differentes) des 
installations differentes comportant des dossiers de meme nom que Ton 
souhaite publier sur le meme serveur Web. 

Sl\ convient done de differencier ces elements en caracterisant chaque 
« installation ». 

^Une installation prend pour nom une solution Adonix et est caracterisee par 
un code alphanumerique defini au niveau de la console. 

s Ce code est stocke dans le fichier de configuration solution.xml qui se trouve 
au dessus du repertoire racine du dossier mere (classiquement dans le 
repertoire DOSSIERS sur une installation Windows) 
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2.1 Notion de solution Sage X3 



Database 

Serveur 


X3 Application 
Serveur 


Connection 
•_ Serveur 


Serveur d’impression 




Windows 

Client 





Application 

tiers 

(Web Services) 
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2.2 Zoom sur le serveur WEB 
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2.3 Traitement d'une requete Web Service 



lication X3 


Protocole Adonix 

-5— 


Serveur WEB 
Pool de connexion 


1. 

2 . 

3. 

4. 

5. 

6 . 

7. 


L'internaute demande une page du site 
Le site web invoque le service WEB X3 
Le serveur WEB X3 contacte le serveur X3 
Le serveur X3 execute le traitement 2 

Le serveur X3 donne le resultat au serveur WEB X3 
Le serveur WEB transmet la demande au site WEB 
Le site WEB actualise la page et la transmet a I'internau 


:e 


I nternautes 



• @ 


Site WEB 
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2.4 Traitement d'une requite Web Service 


• 1 - L'internaute demande une page du site 

• II demande une page dans laquelle il y a une interaction avec X3 ( 
creation d'une commande, consultation d'un tarif ... ) 

• 2 - Le site web invoque le service WEB X3 

• Pour repondre a la demande de l'internaute, il faut dans le code du site 
WEB avoir au prealable integre un des services WEB X3, on I'invoque en 
faisant varier les parametres des methodes qu'il contient. 

• L'invoquer reviens a construire le message SOAP et le mettre dans une 
requete HTTP a destination du serveur WEB X3 

• 3 - Le serveur WEB X3 contacte le serveur X3 

• Le serveur WEB X3 decode le message et le met sous une forme 
comprehensible par le serveur X3, il lui transmet I'information via I'une 
des connexions deja etablie. 

• 4 - Le serveur X3 execute le traitement 

• Le serveur X3 execute un programme wrapper qui se charge de garnir les 
champs des ecrans et de declencher le scenario objet ou d'executer le 
programme demande 
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2.4 Traitement d'une requite Web Service 


5 - Le serveur X3 donne le resultat au serveur WEB X3 

• Pour le serveur X3 il n'y a pas de difference entre une connexion de ce 
type et une connexion de type client/serveur classique, il dialogue avec le 
serveur WEB comme il le fait avec le client graphique X3. 

6 - Le serveur WEB transmet la demande au site WEB 

• Le serveur WEB encode la reponse d'X3 pour la mettre sous la forme d'un 
message SOAP 

• Le message SOAP est encapsule dans une requete HTTP et envoye au site 
WEB 

7 - Le site WEB actualise la page et la transmet a I'internaute 
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////////// 


2.5 Fonctionnement du pool do connexion 


- Le pool de connexion est le systeme qui permet : 

• D'etablir les connexions sur le serveur X3 

• De gerer les files d'attentes des demandes 

Etape 1 - Demarrage des pools de connexion 

• Soit automatique lors du demarrage du serveur WEB 

• Soit par une demande de demarrage explicite 


Serveur de traitementX3 



Serveur WEB Service X3 


Pools de connexion 

4 entrees APP 

1 entree TEST 




Dans cet exemple les pool de connexion demarrent et lancent 4 sessions 
sur le serveur X3 sur le dossier APP et 1 sur le dossier TEST. Au total 
5 licences de type web service sont consommees 
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2.5 Fonctionnement du pool de connexion 


Etape 2 - Un pool est sollicite : une ou plusieurs requetes sont arrivees 


Serveur traitement X3 



3 

Requete 1 
Requete 2 



Serveur de web service 

Pool de connexion 

Requete 1 
Requete 2 

Requete i 

Requete 4 

^ Requete f 

Requete 3 
Requete 4 
Requete 5 



Site WEB 



1. Plusieurs requetes arrivent en meme temps du site web 

2. Le pool de connexion va distribuer les requetes selon les connexions disponibles 

• Si aucune connexion n'est disponible le pool empile la requete 

• Les requetes sont depilees (FIFO) au fur et a mesure de la disponibilite des connexions 

3. Le serveur WEB X3 utilise une des connexions pour traiter la demande 

• Le nombre de connexion depend du parametrage du serveur de web service 

• Et du nombre total de licence web service disponible sur le serveur X3 
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Formation Web Services Sage X3 


3. Installation & configuration 

3.1. Installation du serveur 

3.2. Configuration du serveur 

3.3. La page technique du serveur de web service 
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Le serveur de web service est une des applications du serveur WEB 
X3 (servlet), il faut done que le serveur WEB X3 soit 
prealablement installe. Son installation consiste a : 

• Sur le serveur Web Adonix V140 

• Installation des composants freeware 

s Java Software Development Kit version 1.4.2_03 
^Apache Tomcat version 4.1.27 
^ Apache HTTP Server version 2.0.48 

• Depose de I'application Web 140 

• Sur le serveur d'application X3 

• Installation Apache HTTP Server version 2.0.48 

• Configuration a faire depuis la Console 

> Publication de la solution 

s Declarer le nom de I'Alias de la solution a publier 

s Specifier le chemin d'installation du serveur HTTP installe sur le 
serveur d'application X3 

> Configuration du serveur Web 
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3 Installation & configuration 


Version V5.0 


• Sur le serveur Web Adonix V50 

• Installation des composants freeware 

s Java Software Development Kit version 1.4.2_03 
^Apache Tomcat version 5.5.20 
^Apache HTTP Server version 2.0.59 

• Depose de I'application Web V5 

• Sur le serveur duplication X3 

• Installation Apache HTTP Server version 2.0.59 

• Configuration a faire depuis la Console 

> Publication de la solution 

s Declarer le nom de I'Alias de la solution a publier 

s Specifier le chemin deinstallation du serveur HTTP installe sur 
serveur duplication X3 
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3.1 Installation du serveur 


Une fois le serveur WEB installe 

- Si le dossier etait deja accessible en mode WEB il faudra juste s'assurer de sa 
version. 

- 11 faut publier les differents dossiers, en configurant le serveur WEB 

- Cette operation est a realiser en utilisant la console ( cf. cours installation ) 


Licence Web service 

- Le decompte des licences se fait separement 
des sessions primaires 






><>’ Visu licence 


Fichier Edition 

Editeur 

Outils Affichage 

? 

D| M 

4 

► | M 


o 

1 ft 


Fichier destination 


e:\adonix\v140\RUNTIME 
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3.1 Installation du serveur 


Version minimum pour utiliser les web services 

- Applicatif X3 : Version 143 Liste de patch N°ll 

- Serveur WEB : 14W20 

- Runtime X3 : 14R318 

- Console : 14S25 

Version conseillee pour utiliser les web services 

- Applicatif X3 :Version 143 Liste de patch N°15 

- Serveur WEB : 14W31 

- Runtime X3 : 14R319 

- Console : 14S35 

- Dans cette version une supervision a ete ajoutee pour tenir compte des 
architectures client qui incluent un firewall. 
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3.2 Configuration du serveur 


Le serveur de web service doit etre au prealable configure pour etre 
utilise, cette operation est a realiser depuis la console de 
configuration Sage X3 


Raccourci bureau 



■ Le concept de deposez - cliquez 

■ Parametrage facilite des composants 

■ Assemblage et administration centralises et simplifies 

- d'une architecture integree (un portable par exemple) 

- a une architecture multi-tiers elaboree 
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3.2 Configuration du serveur 


Console de configuration Adonix - 14s.025 


Console Affichage Outils ? 



1 Lancer la console de configuration, choisir 

«Serveurs WEB» 

2 Choisir le serveur concerne 

3 Choisir la solutions concernee 


X4WEB 4032P sur 4032p.asn.adx 


Configuration Administration Publications Webservices 


l=k 


Chargement (ermine. 


i 


□ 


'-i 


lAjouter un groupe de connexions vers ce serveur de traitement I 

- '^J *X4 - IIU:X4J- - 

a X3 

B |_) *DEMOFRA ^_ 

SUfftj 


*X4 - 4032p (3300) 


4 Cliquer sur Tonglet «Webservices» en V140 
ou en V5 utiliser I'icone 



5 Choisir le dossier sur lequel les web services seront 
utilises 
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3.2 Configuration du serveur 


X4WEB4032P sur 4032p.asn. 

adx 


Configuration Administration Publications Webservices 


Chargement termine. 


□ ii z 


6 Cliquer sur « + » pour aj outer un nouveau groupe de connexion 


I Ajouter un groupe de connexions vers ce serveur de traitement [ 

- — » i «n—75-1 — liu.at i-—- 1 

l±J L_1 X3 

B *D EMOFRA _ 

B |^ Demo portable - [ID :DEMO_P] 


7 Renseigner les parametres suivants : 


Nom 

Valeur 

alias 

DEMO P 

libelle 

Demo portable 

solution 

X4 

serveur 

4032P 

port 

3300 

dossier 

DEMOFRA 

langue 

FRA 

utilisateur Adonix 

ADMIN 

mot de passe Adonix 

utilisateur systeme 

Administrateur 

mot de passe systeme 

CRYPT: vdosgrRdosmT xusva 

taille di-Lqrnuije. 

<=;_ 

taille initiale du groupe 

2 

connexion automatique 

on 

entrees reservees 

on 



Alias : Nom dome au groupe de connexion 

Libelle : I ntitule du groupe de connexion 

Langue : Code langue X3 utilise pour le demarrage du groupe 

Utilisateur Adonix : Code user X3 utilise pour le demarrage du groupe 

Mot de passe Adonix : Mot de passe user X3 utilise pour le demarrage du groupe 

Utilisateur systeme : Code de I'utilisateur reseau ( compte windows ) 

Mot de passe systeme : Mot de passe du user reseau 
Taille du groupe ; Nombre de connexion simultanee maximum possible 
Taille initiale du groupe : Nombre de connexion ouverte des le demarrage du groupe 
Connexion automatique : Demarrage automatique du groupe de connexiot 
Entree resen/ee : Obligation de signer chaque requete 



8 Cliquer sur Enregistrer, la console configure le serveur de WEB service 

34 © 2006/2007 Sage - Midsize And Large Businesses 
























3.2 Configuration du serveur 



£ 

* 

3 

<%> 

2* 1 


Accueil 

Nouveau 

Supprimer 

Configuration 

Services 

Publications 

Webservices 


Solutions 


Ajouter Supprimer Appliquer 




Serveurs d'editions 


Serveurs Web 


n 


WebServices 


& m Z » 

Q ^ WEBV5 sur sagex3v5 [ID : WEE 
ac^0 Sage Paie et RH sur sagex3 
E) Sage X3 Entreprise sur sage 

UJ DEMOFRA 

a x3 


► ■ □ ii 

E) £1 Sage Paie et RH sur sagex3v5 [ID:RHV5T] 

0 ED SageX3 Entreprise sur sagex3v5 [ID:X3V5T] 

B i_| DEMOFRA 

£i ■$> X3V5T_sagex3v5_1801 - sagex3v5 (1801) 


X3V5T - DEMOFRA - sagex3v5 - 1801 - [ID:SageWS] 


& ... (5) 

0 m X3 

a X3V5T_sagex3v5_1801 - sagex3v5 (1801) 


|=^X3V5T - DEMOFRA - sagex3v5 -1801 - [ID:SageWS] 1 fl ® ^ 

Parametres Valeur 


alias 

S ageWS 

libelle 

X3V5T - DEMOFRA - sagex3v5 • 1801 

langue 

FRA 

utilisateur X3 

ADMIN 

mot de passe X3 

utilisateur systeme 

X3V5 

mot de passe systeme 

CRYPT :umuccRrvo2 

taille du gtoupe 

5 

taille initiale du groupe 

1 

connexion automatique 

on 

entrees reservees 

on 
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3.3 La page technique du serveur 


Pour verifier que le serveur de web service est operationnel, il faut : 

■ ouvrir la page technique avec I'url : http://localhost: 1898 

■ et cliquer sur I'onglet Serveur de Web Service 

- Une page comme celle ci doit apparaitre : 


H Serveur Adonix X3Web - Microsoft Internet Explorer 


Fichier Edition Affichage Favoris Outils ? 

o Precedente ^ o - @ m ft p Rechercher 'v^' Favoris €> 


Q © ■'S 



Adresse http://localhost:1898/root/index.jsp __ v Cl OK Liens 


(CCl} Home 

Serveur de 

Serveur de web 

testeur de web 

Serveur de 

Serveur de 

Serveur 

Serveur de 

Serveur de 

cache 

services 

services 

terminaux 

workflow 

d'edition 

sessions 

connexion 











^- 

„ Serveur de WebServices 


Services 


Pools de connexions du serveur de WebServices - Etat des groupes d'entrees 


Utilitaires 

• Pools de connexions 

• Cache des descriptions 

• Le serveur axis 

• Les stubs pour axis 

Trace 


Bat du pool j Conficiui ation <lu pool 

Action 

Demarrage de tous les groupes ~~] [ Arret de tous les groupes 
Groupes d'entrees DEMO_P 


A Dioi>os. 


• Activite du serveur 

• Realaaes 

• Acces aux fichiers 



<admreply request="GetPoo1Infos" > 

<entries state="2 ,r statelib="demarre'' id="127810530809414432 n > 


<descr> 

<poolentries alias =,, DEMO_P" state="2 ,f statelib^demarre" id= ,, 127810530809 i ll4432 
<1 istentries size =,, 2" id= ,, 12781053080941 i 1432_CEntr ies" > 

<poolentry pid= , '2 620 ,r connected=''true" available= "true" free =,, t 
<poolentry pid="4332" connected= ,, true" available="true'' free=''t 
</listeneries> 

</poolentries> 

</descr> 

</entries> 

< / adror e p 1 y > 


Le demarrage des groupes d'entrees peut se faire depuis cette page ... 
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gyp 
















































3.3 La page technique du serveur 


ou depuis la console 



Arret du groupe 


B a EWorld 

- J *X4 - [ID:X4] 

+ X3 
- _J *DEMOFRA 

Q *X4 - 403 2p (3300) 


Suspension du 
groupe de 
connexions 


Demo portable - [ID :DEMO_P] 
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3.3 La page technique du serveur 


I dentification du numero de 


processus adonix 

_ A 


><>' DEMOFRA Adonix .J - [Surveillance utilisateurs] 


Gestionnaire des taches de Windows 


Fichier Options Affichage ? 


Gestionnaire des taches 

Processus Performances Miseenrese gyp |q serveUT X3 


■ | Fichier Edition M Outils Tri Affichage ? 

D 


H ◄ 

► 

►M <H 

iPlI 

X 

%l filial 


Mach 


4032P 






Norn 
adonix.exe 
adonix.exe 
adonix.exe 
adonix.exe 


lorn de I’utilisateur 
fdministrateur 
Administrateur 
4332 Administrateur 
4520 Administrateur 



Poste cli Ml 

Login 

Service 

Ident 1 

| Ident 2 

| Adresse IP 

Date 

Heure 

Type 

1 

4032P.as|bdx 

ADMIN 

3300: p 

229462 

J 59394 

4032P.asn.adx 

21702706 

21:59:21 

Web services -4-r 

2 

4032P.aJf.adx 

ADMIN 

3300: p 

1228885 

|277505 

j 4032P.asn.adx 

21/02/06 

21:58:50 

Web services f 

3 

4032P .^i.adx 

ADMIN 

3300: p 

524289 

1 4387843 

4032P.asn.adx 

23/02/06 

21:09:48 

Ptimaire 

4 

BATC® 

ADMIN 

3300 

32813 

14097 

4032P 

21/02/06 

23:06:59 

Batch 

5 









identification session WEB 



f actifs 

pcessus Processus 


T otal sessions 


Nombre total de licences 
WEB service 


2620. 


Nombre total de licences 
Web Service consommees 


3 


Sessions primaires 

1 

( 24 ) 

Sessions secondaires 


( 20 ) 

.^Batchs 

1 

( 40 ) 

Web services 

2 

( 5 ) 


Etat du groupe de connexion 



<admreply request="GetPoolInfos" > 

<entries state= ,, 2" statelib="demarre" id="127810530809414432" > 

<descr> 

<poolentpar€s alias="DEHO_P" sta^ 3tatelib="demarre" id="127810530809414432 
1 is tent r ies size="2^^ra='^^^^C530809414432_CEntries" > 

<poolentry ptl="2 620" cAmected="true" available= "true" free="t 
<poolentry pi^^^§Bii^^° nnec,: • ed=,,tr ' ue ' , available="true" free="tM 


Etat du pool de connexion 


. t ■* • 

















































Web Services Sage X3 


4. 


Mise en oeuvre 

4.1. La modelisation dans X3 

4.1.1. Modelisation des sous-programmes 

4.1.2. Modelisation des objets 

4.2. Publication des WEB services 

4.2.1. Le generateur de WEB services 

4.2.2. Description XML generee 

4.2.3. Regies de generation 

4.3. Gestion de la coherence 

4.4. La mise au point 

4.4.1. Regies de developpement 
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4.1 La modelisation dans X3 


Pour utiliser des fonctions d'X3 dans le mode web services, il faut au 
prealable que ces fonctions soit modelisees. 

Les modeles compatibles avec les web services sont : 

■ Les sous-programmes 

■ Les objets 

- Celui-ci permet ('utilisation des services web Objet et Liste 

- Ce modele permet d'etre independant du mode d'utilisation : 

s Client windows 
s Client Internet explorer 
^ Import de donnees 
s Web Service 
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4.1.1 Moderation des sous-programmes 


m abl ® ®to Pf© Developpement > Dictionnaire traitements > Sous-programmes 



Descriptif 



Parametres 



Code 

Intitule 

Type 

Dim 

Type d'aigument 

Gioupe de publication 

1 

WEBS 

Nom de publication 

Char 

1 

Par valeur 

G1 

2 

RESCLOB 

Resultat 

Clob 

1 

Par adresse 

G1 

3 

HORDAT 

Horodatage 

Char 

1 

Par adresse 

G1 

4 

OK 

Code retour 

Integer 

1 

Par adresse 

G1 

Fi 








Case a cocher 
WEB service : 
Indique que le 
sous programme 
est utilisable dans ce 
mode 


dictionnaire : 


chaque 


Les parametres peuvent etre passes par valeur ou par adresse 

Si ils sont passes par adresse X3 peut transmettre des informations a 

I'application tierce 
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I 



Les sous-programmes destines a etre publies sous forme de Web services sont 
coches « Web », 

Les variables definissant I'interface du sous-programme sont automatiquement 
retrouvees dans le sous-programme 

- Declarer une variable par ligne dans le sous-programme pour garantir la 
recuperation automatique. 

Les informations successives de meme cardinalite sont automatiquement 
rassemblees dans le meme groupe, sauf si on leur associe des norms de groupe 
differents. 

La colonne longueur permet de dimensionner les variables de type caractere, blob 
et clob, definissant ainsi une taille de receptacle pour les blob et clob. Ceci permet 
a I'application cliente d'effectuer un controle supplemental re. 

Un bouton « publication » permet de se debrancher directement sur la fonction 
de publication. 
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4.1.1 Modelisation des sous-programmes 

■ i ~ ^ r ■■tiL ***i~ n‘1 1 - 


Des sous-programmes permettent de gerer de multiples messages 
pour I'execution des sous-programmes en web services (jusqu'a 50 
messages) 

■ Call MESSAGE(MESSAGE) from GESECRAN 
Ajoute un message d'information 

■ Call ADDMESSWARN(MESSAGE) from AWEB 
Ajoute un message divertissement 

■ Call ERREUR(MESSAGE) from GESECRAN 
Ajoute un message d'erreur 


Les messages sont transmis dans le flux XML de reponse et sont exploitables 
dans I'application cliente. 
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4.1.1 Modilisation des sous-programmes 


Les limites 


■ 50 variables au maximum pour un sous-programme, mais toutes les 
variables peuvent etre dimensionnees. 


■ La table de description des sous-programmes est une table systeme 
(c'est la meme pour tous les dossiers de la solution). 


■ 50 messages maximum. 


■ Les programmes qui sont modelises ne doivent pas ouvrir de fenetre 
pour faire saisir des informations a I'utilisateur. II doit etre autonome 
avec les parametres fournis. 


■ Toutes les instructions liees aux affichages sont a proscrire, en 

revanche toutes les instructions de lecture et de mise a jour de la base 
de donnees sont bien entendu disponibles. 
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4.1.2 Modelisation des objets 
Les-dlftfir«nt« frvD£S-d£-canj3£xjDJ)s. 


A la connexion dans toute application developpee en technologie 
Adonix on distingue les types de connexion suivants : 

- Session primaire adxtyp=l (C/S) ou 9 (Web) 

- Session secondaire adxtyp=2 (C/S) ou 10 (Web) 

- Batch adxtyp=3 

- Terminal VT adxtyp=5 

- Web service adxtyp=12 


■ En fonction des droits portes par la cle Adonix, la connexion est 
autorisee ou non, En particulier le serveur de Web services ne 
pourra pas demarrer si la cle n'autorise pas au moins 1 connexion. 


■ En mode Web service la variable globale numerique GWEBSERV est 
egale a 2 
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4.1.2 Modelisation des objets 


■ Les objets X3 sont bien entendu eux aussi stockes dans des 
dictionnaires dans lesquels on retrouve : 

- La description de la liste gauche 

- La description de chacun des ecrans qui le compose 

- La description des options particulieres 

- La table principale a mettre a jour 

- Les traitements L4G qui sont lies a cet objet 

■ Le dictionnaire n'est, a priori, pas a completer. Si I'objet est disponible 
en client/serveur il I'est aussi en mode web service. Cependant de 
legeres adaptations peuvent etre necessaire pour acceder aux ecrans de 
saisie complementaires ( adresse dans la commande par exemple ). 


■ L'objet est le modele le plus couramment utilise dans X3, les fonctions 
qui n'ont pas ete developpees avec ce modele sont en general 
encapsulate dans un sous programme a realiser en specifique. 
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4.1.2 Moderation des objets 


Mode d'affichaae des cham 


n 


■ Une zone peut etre ; 
- Saisie 


s Que ce soit en web service ou en C/S la zone sera transmise au client 
- Affichee 


s Que ce soit en web service ou en C/S la zone sera transmise au client 
- Invisible 


s En C/S la zone n'est jamais transmise au client, en web service cela depend du 
mode de publication ( zone invisible oui/non ) 

- Technique 


s Que ce soit en web service ou en C/S la zone ne sera jamais transmise au client 


Les zones non transmises au client sont bien 
entendus disponibles dans la classe [M] 

Cela evite de grossir inutilement les flux 
client/serveur 


■BTHiai 


■i e % a m >2 


■a a 


Code ecran l:ia;il 

BPR1 

Intitule Identite 


♦ General ^ Champs | 


Champ 

Intitule 

| Col (Type |hienu 

| Long | Saisie 

16 

BPRACC 

Tiers divers 

1 M 1 

20 Saisi 

17 

PRVFLG 

Prestataire 

1 M 1 

20 Saisi 

18 

BPTFLG 

T ransporteur 

1 M 1 


19 

WSEP 


W 

^^20 Technique 

20 

D00FLG 

Donneur d'ordre 

1 M 1 

■ 20 Saisi 

21 

FCTFLG 

Factor 

1 M 1 

^^20 Invisible 
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Une action peut etre executee 

- Interactive 

s Action executee uniquement en C/S 

- Toujours 

s Que ce soit en web service ou en C/S Taction est executee 

- Import / Web service 

^Action executee uniquement en web service et en import 


Ne sont jamais executees : 

- Les actions avant bouton 


b %si f f a a 


Code ecran |S0H4 SOH4 


Intitule Gestion des commandes 


- Les actions Bouton N 

- Les actions de selection 

- Clic sur une icone 


► General O Champs | 



Champ 

Intitule 

Col 

Type 

Menu 

Long 

Saisie 

16 

DALLTYP 

Type allocation 

1 

M 

450 

15 

Saisi 

17 

TDLQTY 

Qte a livrer 

1 

QTY 



Saisi 

18 

GROPRI 

Prix brut 

1 

MD5 



Saisi 

19 

DISCRGVAL1 

$ 

1 

REM 



Saisi 

20 

DISCRGVAL2 

$ 

1 

REM 



Saisi 

21 

DISCRGVAL3 

$ 

1 

REM 



Saisi 




Type M 

1 

lnit bouton 


2 

Avant zon< 


3 

Controle 


4 

Controle 


5 

Boutonl 



Interactive 
T oujours 


T oujours 
Interactive 



Descriptif 

Valeur 

1 

ABFIC 

"SOQ" 

2 

ABREV 

"SOH4" 

3 

ALT 

GBIDI1 

4 

BPRNUM 

[M:SOHO]BPCORD 

5 

BPRREF 

[M:SOHO]CUSORDREF 

6 

CFGPHASE 

0 
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■ Modelises dans le dictionnaire (exemple contact dans la fiche client) 

■ Donnent lieu a une generation particuliere, mais doivent respecter : 

- une normalisation des noms de champs (nom champ 
detail = «constante»+nom champ invisible dans bloc tableau 

✓ exemple KCNTSRV=«K»+CNTSRV) 

- Le dernier champ de type numerique ( C ) et invisible du bloc detail est 
considere comme la variable de controle du numero de ligne dans le 
tableau et est initialisee en tant que telle par le programme wrapper 
lors de I'appel de chaque ligne, exemple : KNOLIG dans CNTBPC. 

- Le bloc liste doit faire reference au bloc tableau 


It at,II ® ? to © Developpement > Dictionnaire traitements > Ecrans 


♦ General | ♦ Champs 


Code ecran CNT 


CNT 


Intitule Contacts 


H Ecran modele 


Code activite 

1 II 1 

Module 

Superviseur 

«ar 


Taille 

Onglet 

a 25 

74] 


T raitement standard T R T B PA 
T raitement vertical 


Traitement specifique SPECNT 


Type bloc Act | Ligne| Options | Parametre | Representation Bloc tableau |vue poitail 




Title du bloc 



2 


3 




Invisible 
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4.1.2 Modelisation des objets 


Les ecrans liste / detail 





Champ 

Bloc 

Pos 

Intitule 


Champ 

Bloc 

Pos 

Intitule 

20 

KCCNCRM 

2 

1 

Code 

4 

CNTFNA 

1 

4 

Prenom 

5 

CNTCRY 

1 

5 

Pays 

21 

KCNTTTL 

2 

2 

Civilite 

6 

CNTFLG 

1 

6 

Par defaut 

22 

KCNTLNA 

2 

3 

Nom 

7 

CNTTTL 

1 

7 

Civilite 

*23 

KCNTFNA 

2 

4 

Prenom 

8 

Q 

CNTFNC 

rWTQRV 

1 

1 

1 

8 

9 

10 

Fonction 

24 

KCNTFNC 

2 

5 

Fonction 

10 

CNTADD 

Adresse 


£5 

26 

KCNTSRV 

KCNTMSS 

2 

2 

6 

7 

Service 

Mission 

ii 

CNTTEL 

1 

11 

T elephone 

27 

KCNTBIR 

2 

8 

Date naissance 

12 

CNTFAX 

1 

12 

Fax 

28 

KCNTADD 

2 

9 

Adresse 





36 


2 20 No 


1 C 


2 Invisible 


■ Seuls les champs du tableau sont exportes en XML. Les champs 
invisibles du bloc tableau sont automatiquement ajoutes. 


■ Le programme de controle deverse les lignes du tableau dans le bloc 
detail ligne par ligne et effectue les controles sur champ definis dans 
I'ecran 


■ Attention ; 

- Les actions du tableau ne sont pas executees 

- II faut en cas d'action MODIFY, et de modification dans ce tableau, 
charger la zone precisant le nombre de lignes du tableau (exemple 
NBCNT dans les contact), faute de quoi c'est le plus grand numero de 
ligne indique qui est pris comme dimensionnement du tableau 
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Les ecrans complementaires 


■ Dans le dictionnaire Objet, II est possible de definir de 0 a 8 ecrans 
complementaires avec une abreviation associee. 

■ Ces ecrans vont etre 

- Pris en compte dans la structure XML produite lors de la generation du 
Web service, comme des ecrans de la fenetre 

- Ouverts par le programme automatique associe a la fenetre 

- Declares comme des onglets de la fenetre lors de I'ouverture de la 
fenetre dans Instruction Inpbox 

- Charges dans les variables du flux XML de reponse du Web service 

- Charges via une instruction Saizo a partir des informations envoyees pa 
le Web service lors d'une action de CREATE ou MODIFY 


■ L'applicatif devra assurer dans le contexte Web service 
(GWEBSERV=2) 

- Le chargement des masques complementaires (etiquette lien) 

- La mise a jour des tables a partir des masques lors de I'ecriture 
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Les ecrans complementaires 


■ Une evolution a ete faite pour illustrer le principe de fonctionnement 
des ecrans complementaires. Elle concerne I'objet SOH. 

■ Cette evolution permet de recuperer en lecture/ecriture : 

- Les adresses de commande, livraison, facturation 

- Les textes entete et pied de la commande 


■ Pour la mettre en oeuvre il faut 


- Recuperer le source SPESOH livre a titre d'exemple et soit le 
mettre en ligne, soit inclure son contenu dans le SPESOH existant 

- Definir 5 masques complementaires comme suit dans I'objet SOH 


s ADRBPC 

✓ ADRBPC 

✓ ADRBPC 

✓ ACLOB 
^ ACLOB 


ADB1 

ADB2 

ADB3 

ACL1 

ACL2 



-ex 

b % b m ii ? -a a 


Code objet SOH Intitule Commandes 


Table liee SORDER Commandes de vente - Entete 



♦ Generali ♦ Selection :<$> Envuonnement | 



T ables a ouviir 

Expression de lien 

Abrev 

Code activite A 

1 

SORDERP 




2 

SORDERQ 




3 

BPCUSTOMER 




4 

BPCUSTMVT 





5 BPDLVCUST 

< 

Import 

Table| Ectan | Tableau 

1 SORDER SOHO 

2 SORDER S0H1 

3 SORDER SOH2 

4 SORDER S0H3 

5 SORDERQ SOH4 NBLIG 

6 SORDERP SOH4 NBLIG 
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4.2 Publication des WEB services 


. \ r 1 

r r’ 

l r r 7? 

r ) 

r \ \ H 



Li 



■ Une fois I'objet ou le sous programme decrit dans le dictionnaire, il faut le 
publier. 

■ La publication permet de generer un flux XML decrivant I'objet ou le sous 
programme. 

■ Ce flux sera utilise ensuite par le serveur web pour decoder les requetes 
emanant de I'application tierce. 

■ Les web service X3 etant generiques, les elements variables tels que les 
noms des champs pour un objet ou les parametres pour un sous 
programme, sont passes sous la forme d'un flux XML, la structure de 
celui-ci est determine par la description donnee dans le dictionnaire. 

■ La publication genere aussi un programme wrapper en L4G adonix 

- II sert d'interface entre le developpement X3 et le serveur de Web 
services et gere: 

^ Les parametres d'entete 
s Les messages 

s Les flux montant et descendant de donnees 

■ Les programmes wrapper sont appeles par le serveur de Web services 
dont le role est de serialiser / deserialiser le flux soap de / vers les 
parametres attendus. 
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4.2.1 Le generateur de WEB services 


Fonction de publication 


® ® to |*"© 


Developpement > Dictionnaire traitements s Generation web services 



B'wi£] Q<3 <] (> 00 w X B B £ JB abl $ to 



Pret 
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4.2.1 Le generateur de WEB services 


Fonction de publication 


■ Cette fonction permet de publier des objets avec pour chacun le choix 

- de la transaction (si cet objet a des variantes) 

- de la publication ou non des champs invisibles (les champs de type 
technique ne sont jamais publies) 

■ II est egalement possible : 

de choisir le nom de publication ( nom public de I'objet ou du sous 
programme) 

de lister les elements publies 

de de-publier des elements precedemment generes 

de generer tous les Web services d'un dossier ( bouton publication 
globale ) 

■ II est a noter que lorsqu'un nom de publication a ete donne a un element 
(objet ou sous-programme), ce nom est systematiquement re-propose 
lors des generations suivantes. II n'est pas possible de publier 2 fois le 
meme couple objet-variante avec deux noms differents, ni de publier un 
couple objet-variante avec et sans les champs invisibles. 
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4.2.1 Le generateur de WEB services 


Fonction de publication 


■ Le programme de publication cree : 

- une structure XML de nom «Nom de publication».xml qui est 
stockee dans le repertoire X3_PUB/ «Nom du 
dossier»/GEN/ALL/WEBS 

- un programme wrapper en L4G 


■ Avec chaque programme wrapper un programme de test automatique 
est cree qui permet d'appeler un sous-programme publie et d'appeler 
un objet par une des quatre methodes proposees (lecture, creation, 
modification, suppression) et par la methode liste. 


■ Les elements generes sont horodates et un controle est effectue par le 
serveur de Web services avant tout appel a un programme wrapper 
pour s'assurer que la version publiee et utilisee est bien la plus a jour. 
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4.2.2 Description XML generee 


1 1 http://4032p/Adonix_X4/DEMOFRA/GEN/ALL/WEBS/SOH.xml - Microsoft Internet Explorer 


Fichier 

Edition Affichage Favoris Outils ? 


o- 

O ’ L“] L»] / Rechercher Favoris ^) | 0 ’ 0 |J @ 


Adresse 1 

^]http://4032p/Adonix X4/DEMOFRA/GEN/ALL/WEBS/SOH.xml 

v OK Liens 


A 


<?xml version-'!..0" encoding=“utf-8” ?> 

- <ADXDOC PNA="SOH" NAM="WOSOHSTD" TIM="20060109111503" OBJ="SOH" TRA="STD" FOL="DEMOFRA” S0L="X4" WRP="W3SOHSTD" 
USER="ADMIN" VER="3. 20051028" HEAD="1"> 

- <ADXDATA> 

- <GRP NAM="SOHO_1" TYB="List" DIM=“1"> 

<FLD NAM="SOHNUM" TYP="Char" M0D="Input" LEN="15" C_FRA="IMumero" /> 

<FLD NAM="REVNUM" TYP="Integer" MOD— "Display" /> 

<FLD NAM="SOHTYP" TYP="Char" M0D=''Input" LEN="3" /> 

<FLD NAM="SALFCY" TYP="Char" MOD="Input" LEN="3" C_FRA="Site vente" /> 

<FLD NAM="CUSORDREF" TYP="Char" MOD="Input" LEN="20" C_FRA="Reference" /> 

<FLD NAM=”ORDDAT" TYP='Date ' MOD=''Input" C_FRA="Date“ /> 

<FLD NAM="BPCORD" TYP="Char" M0D="Input" LEN="10" C_FRA="Client cde" /> 

<FLD NAM=”BPCNAM" TYP="Char" MOD="Display" LEN="35" /> 

<FLD NAM="CUR" TYP="Char" MOD="Display" LEN="3" C_FRA="Devise" /> 

^ /rnn--. 


Le fichier XML produit est ecrit en codage UTF8, ce fichier XML peut etre 
demande par I'application cliente ( methode GetDescription ) qui peut 
I'exploiter, pour generer des ecrans par exemple. 

L'entete du document est decrite dans le noeud ADXDOC. 

Ses proprietes sont les suivantes : 
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4.2.2 Description XML generee Noeud 

<ADXDOC> 


Entete du fichier XML OB JET : 


<ADXDOC PNA="OBJSOH" 

NAM =" WOSOHSTD" 

TIM = "20060109111503" 

OBJ = "SOH" 

TRA="STD" 

FOL="DEMOFRA" 

SOL="SOLX3" 

WRP="WJSOHSTD" 

USER="ADMIN" 

VER="3. 20051028" 

HEAD = "1"> 


Nom de publication de l’objet 

Nom de la fenetre associee a V element 

Horodatage de generation 

Nom de l’objet genere 

Nom de la transaction choisie 

Nom du dossier 

Nom de la solution Adonix 

Nom du programme wrapper 

Utilisateur X3 ayant declenche la generation 

Version du generateur 

Version du protocole d’encapsulation 
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4.2.2 Description XML generee Noeud 

<ADXDOC> 


Entete du fichier XML Sous programme : 


<ADXDOC PNA="STOCKSITE" 
TIM = "20060208121856,, 

PRG = "ZSTOCK" 

SPG = "STOCK" 

FOL="DEMOFRA" 

SOL="SOLX3" 

USER="ADMIN" 

VER="3. 20051028" 

HEAD = "1" 

WRP= "WRSTOCKSITE" 

C FRA= "Recherche de Stock" > 


Nom de publication du sous programme 

Horodatage de generation 

Nom du programme publie 

Nom du sous programme publie 

Nom du dossier 

Nom de la solution Adonix 

Utilisateur X3 ayant declenche la generation 

Version du generateur 

Version du protocole decapsulation 

Nom du programme wrapper 

Designation du sous programme 
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gyp 




4.2.2 Description XML generic Noeud 

<GRP> 


Le noeud GRP decrit soit un bloc ecran soit un 
groupe de parametres d’un sous programme : 

Exemple bloc de type liste : 

<GRP NAM = "SOHO_1" Code ecran et numero de bloc 

TYB="List" Type de bloc (valeurs possibles : Table, List, Piet, Text, Hidden) 

DIM = "1"> Nombre de lignes maximum Toujours 1 dans les bloc de type 

liste 

Exemple bloc tableau : 

<GRP NAM = "SOH4_l" 

TYB= "Table" 

DIM = "200" 

IDTAB="SOH4~NBLIG" 

OPT="IAD"> 

Suppression 

Exemple groupe de parametres pour un sous programme : 

<GRP 

NAM = "G1" nom du groupe dans le dictionnaire des sous programmes 

DIM = "1"> Nombre d'occurences des parametres contenus dans ce groupe 


Bloc de type tableau 

Nombre de lignes maximum 

Code ecran + variable de bas de tableau 

Option du bloc ecran : Insertion, Annulation, 
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4.2.2 Description XML generee Nceud 

<FLD> 


Le noeud FLD decrit soit le champ d’un ecran soit un 
parametre d’un sous programme : 


Description d'un champ d'un 
<FLD NAM = "ORDSTA" 

TYP= "Integer" 

MOD = "Display" 

LEN = "3" 


DIM = "2" 


MEN = "415" 

C_FRA= "Devise" /> 


ecran : 

Nom du champ 

Type du champ ( integer, char, blob, clob,date, decimal ) 

Mode d'affichage du champ ( input, display, hidden ) 

Longueur,si le champ est un menu local I'attribut LEN n'est pas 
present 

Nombre d'occurrences du champ,si = 1 I'attribut DIM n'est pas 
present 

Numero du menu local 

Intitule du champ le nom de I'attribut est C_+code langue 


Description d'un parametre 
<FLD NAM = "STOCK" 
TYP="Decimal" 

PAR="Adr" 

MOD = "Input" 

C_FRA= "Stock article /> 


Nom du parametre 

Type du parametre ( integer, char, blob, clob,date, decimal ) 
Mode de transmission du parametre 
( Adr:par adresse, Value:par valeur ) 

Toujours input 
Designation du parametre 
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4.2.2 Description XML generee Nceud 

<ADXKEY> 


Le noeud ADXKEY decrit une liste gauche 


<ADXKEY> Liste gauche 
<GRP NAM = "LEFTLIST" 

DIM = "10000"> 

<FLD NAM = "SOHNUM" 
MOD="Display" 
TYP="Char" 

LEN = "30" 

<C_FRA="No commande"/ 
</GRP> 

</ADXKEY> 


Attribut fixe 
Attribut fixe 

Code du champ de la liste gauche 

Attribut fixe 

Attribut fixe 

Attribut fixe 

Intitule de la colonne 
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4.2.2 Description XML generee Noeuds 

<ADXMEN> 


Le noeud ADXMEN decrit les menus locaux 


<ADXMEN> 

<MNU NO = "l"> 

<VAL IND="1" C_FRA="Non" /> 

<VAL IND = "2" C_FRA="Oui" /> 
</MNU> 

<ADXMEN> 


Liste des menus locaux 

Numero du menu local 

Numero et designation de I'iterm du menu 


local 
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4.2.2 Description XML generee Noeuds 

<ADXSER> 


Le noeud ADXSER decrit les actions possibles sur un objet 


<ADXSER> 


Liste des boutons et 


options disponibles 

<MET ID = "READ" C_FRA=' Lire" /> L'attribut ID est fixe les 

intitules sont par langue 

<MET ID = "CREATE" C_FRA="Creer" /> 

<MET ID = "MODIFY" C_FRA="Modifier" /> 

<MET ID = "DELETE" C_FRA="Supprimer" /> 

<MET ID = "LIST" C_FRA= "Liste" /> 

<MET ID = "V" C_FRA="Valorisation" /> Option code « V » du 

dictionnaire des fenetres 


</ADXSER> 
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4.2.2 Description XML generee Noeuds 

<ADXREAD> 


Le noeud ADXREAD donne le champ cle 

<ADXREAD TAB="SORDER"> Nom de la table X3 

<FLD NAM = "SOHNUM" Code du champ cle 

TYP="Char" Type du champ cle 

LEN = "15" Longueur du champ cle 

C_FRA="No commande /> Designation du champ cle 
</ADXREAD> 
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4.2.3 Regies de generation 


■ Une fonction deja publiee doit garder le nom initial de publication (si 
on desire en changer, il faut la depublier et relancer la publication) 


■ Les elements publies sont nativement multi-langue et la structure XML 
est stockee dans le repertoire WEBS du dossier sous X3_PUB/GEN/ALL 


■ Tous les elements generes sont automatiquement horodates, 

memorisent la version du generateur utilise et le nom de I'utilisateur 
X3 qui a lance la generation (GUSER) 


■ La description d'un objet ou d'un sous programme indique que celui-ci 
peux etre utilise par une une application tierce, en revanche rien 
n'oblige a utiliser ce fichier dans I'application cliente. 
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4.2.3 Regies de generation 


■ Si la description XML du Web service appelee n'est pas a jour, elle sera 
automatiquement rafraichie par le serveur de Web services qui 
recuperera la nouvelle description XML et mettra a jour ses structures. 


■ Pour forcer ^utilisation de la nouvelle version du programme wrapper 
une instruction de flush memoire adxmpr=adxmpr est provoquee sur 
les differentes entrees du pool. 


■ Le serveur de Web services assure la serialisation / deserialisation des 
parametres et la mise a jour des structures publiees 


■ Pour qu'un web service beneficie de la modification d'un programme 
L4G alors que celui-ci a deja ete execute, il faut republier I'objet. 


■ L'utilisateur X3 web service ne doit pas avoir le serveur batch en 
demarrage automatique a la connexion 
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4.3 Gestion de la coherence 


■ Lors de la lecture d'une fiche objet, si les champs UPDDAT, 
UPDTIM et UPDUSR sont definis dans la table principale de 
I'objet ces informations sont retournees dans le flux XML de 
reponse dans le groupe ADXTEC 

- WW_MODSTAMP Horodatage de la derniere mise a jour 

- WW_MODUSER Code utilisateur X3 du dernier modifieur 

■ Lors de I'envoi d'un flux de donnees pour modification ou 
suppression : 

- Si et uniquement si la zone WW_MODSTAMP est valorisee (avec le 
contenu obtenu lors de la lecture), le programme va controler si 
I'enregistrement a ete modifie depuis ce timestamp. 

- Dans ce cas un message d'erreur sera envoyee donnant le nouveau 
timestamp, et les modifications seront refusees avec le message : 

« Enregistrement modifie depuis la derniere lecture » + timestamp de la 
modification + utilisateur ayant modifie (si disponible ) 
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4.4 La mise au point 


■ Une fois la modelisation terminee il faut tester pour verifier 
si les objets et les sous programmes publies sont bien 
compatibles avec le mode web service. 


■ Des tests sont necessaires, en fonction des parametrage 
propre a chaque dossier, les objets peuvent reagir de 
maniere differentes (ouverture de fenetres 
complementaires, questions posees a I'utilisateur ) . 


■ Les objets completement specifiques sont eux aussi a 
tester. 


Des regies de developpement sont a respecter. 
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4.4.1 Les regies de developpement 


Les principales contraintes sont liees a des problemes 
d'affichage : 

■ L'instruction infbox ne bloque pas le web service mais 
elle ne ne permet pas de renvoyer un message a 
I'application cliente 

■ L'utilisation de la syntaxe #@ pour acceder aux 
postes client n'est pas compatible (elle plante le web 
service), attention aux imports silencieux ! 

■ L'envoi de mail : ^instruction Send ne fonctionne pas, 
il faut utiliser le meladx.exe pour faire un workflow 
serveur. 
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4.4.1 Les regies de developpement 


■ Les editions ; instruction Report, Toujours I'utiliser 
avec un serveur d'edition. 

- Le parametre superviseur SERIMP est a renseigner 


■ Interruption du programme par I'ouverture d'une 
fenetre : 

Call DIALWIN(W_OK,mess(113,188,1),"ACOPIE") From 
GESECRAN 

N'est pas compatible en mode web service 

■ L'instruction inpbox hors modelisation objet est a 
proscrire 
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■ Ils sont generes lors de la publication d'un objet ou d'un sous 
programme 

- WJ+«Nom d'objet» + «nom de variante» pour les objets sans 
publication des champs invisibles 

- WJ+«Nom d'objet» + «nom de variante»_I pour les objets avec 
publication des champs invisibles 

- WR+«Nom de publication » pour les sous-programmes 

■ Ils constituent une interface entre le developpement X3 et le serveur de 
Web services, Ils gerent 

- Les parametres d'entete 

- Les messages 

- Le flux montant et descendant de donnees 

■ Les programmes wrapper sont appeles par le serveur de Web services 
dont le role est de serialiser / deserialiser le flux SOAP de / vers les 
parametres attendus. 
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Les parametres sont normalises en variables d’entete et flux de donnees. Les variables 
d’entete servent a controler les flux emis et recus. Leur description est la suivante : 


- WW OK 

- WWZONE 

- WWSTAT 

- WW_GRAVE 

- WW MESS 


Integer 
Character 
Integer 
Integer(1..50) 
Character(1..50) 


- WWACTION Character 

- WW IDENT Character 


Statut de retour l=OK , 0=KO 
Zone de sortie en cas d'erreur 
Nombre de messages 

Gravite:l=lnfo, 2=Warning, 3=Bloquant 
Texte du message 

Code action a executer 1'action 
Identifiant (Clel~Cle2~Cle3...) ou 
cle debut, ou criteres de selection rapide si liste 

- WW_NB Integer Nombre d'enregistrements a lire/lus 

WW_HORDAT Character Horodatage de 1'element 

- WW_TAB Character Identifiant de tableau 

• (futures actions SUPLIG et INSLIG) 

- WW_PAR Character Identifiant de lignes (idem WW_TAB) 

- WW_TRACE Clbfile Trace a renvoyer au serveur 

de Web services. Parametres de mise en oeuvre du debugger 


73 © 2006/2007 Sage - Midsize And Large Businesses 







4.4.2 Test avec I'applicatif 


Programmes Wrapper 


■La generation du programme wrapper est une des etapes de la generation du 
Web service. A I'interieur du programme wrapper on trouve un programme de 
test qui permet de valider le fonctionnement de I'objet ou du sous-programme 
en mode Web service, en simulant une execution, sans avoir a tester depuis 
I'application tierce. 


■Lors de I'appel d'un Web service, le serveur de Web service transmet au 
programme wrapper I'horodatage de sa structure locale. Le serveur X3 verifie si 
cet horodatage est conforme a celui stocke sur le serveur. Si oui il repond a la 
requete, si non il renvoie une erreur et le serveur de Web service envoie une 
requete technique pour recuperer la derniere version. 


■Le mode operatoire consiste a developper un programme de test separe du 
programme wrapper, car toute modification de celui-ci sera perdue lors de la 
republication de I'objet. 
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4.4.2 Test avec I'applicatif 


Test liste gauche 


############################### 
## Test liste gauche 
############################### 


Trace du resultat 


Call TEST_LISTE ( 10 ) 
End 


# Nombre de lignes maximum 


i 


Subprog TEST_LISTE(NBLISTE) 

Value Integer NBLISTE 
Call OUVRE_TRACE("") From LECFIC 
Gosub DEFLISTE From WJSOHSTD 

ww_action= "list" # Action liste gauche 

ww_ident= "-disooi-" # Critere : commande du client 

DIS001 _2 

Gosub webliste From wjsohstd # Declenchement de la listed 
Gosub analresobj From wjsohstd # Analyse du resultat _i 

For indice=l To WW_NB 

If indice=l 6 

Call ECR_TRACE(mess(223,123,1) 

Call ECR_TRACE ( "- ",0) 

Endif 

Call ECR_TRACE(num$(indice)" 

WW SEL1(indice) 


)«' DEMOFRA Adonix X3 - [Lecture fichier de trace FI 838] 


• Fichier Edition Outils Options Affichage ? 

D IH Ml Jlftei; | 


abl.l =:!$;== 5+ % 0 HI 'I 


.0) From GESECRAN 
From GESECRAN 


WW_SEL2(indice) 

WW_SEL3(indice) 

WW_SEL4(indice) 

WW_SEL5(indice) 

WW_SEL6(indice) 

WW_SEL7(indice) 

Next indice 

Call ECR_TRACE ( "- ",0) 

Call FERME_TRACE From LECFIC 
Call LEC_TRACE From LECFIC 
End 


0) From GESECRAN # Affichage de la liste- 


From GESECRAN 


17 

18 


25702706 09:49:26 (ADMIN) 


Code retour global : 1 (OK) 


Liste ~DIS001- 


Nombre de messages 


Liste des messages 


OK 


Enregistrement(s) lu(s) 


PRE0804ASN00002 DISOOI 26/08/2004 DUPRE 3 75009 
NOR1204ASN00001 DISOOI 13/12/2004 REF13CANAPE DUPRE 3 75009 
NOR1004PAR00005 DISOOI 28/10/2004 CS/CDE565 DUPRE 1 75009 

NOR1004PAR00004 DISOOI 28/10/2004 CS/CDE565 DUPRE 1 75009 

NOR1004PAR00003 DISOOI 28/10/2004 CS/CDE565 DUPRE 1 75009 

NOR1004PAR00002 DISOOI 28/10/2004 CS/CDE56S DUPRE 1 75009 

NOR1004PAR00001 DISOOI 04/10/2004 CS/CDE565 DUPRE 1 75009 
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L'etiquette Gosub DETAILRES permet d'afficher dans une trace ; 


-Le statut global 

-I'enregistrement qui a ete lu ou ecrit (tous les champs des 
blocs liste et la premiere ligne de chaque tableau) 

-La liste des messages 


######### 

## Test de lecture 
######### 

Call TEST 
End 


Trace du resultat 


Subprog TEST 

Local Char TEXTE(20) 

Local Integer I , J , K 

Call OUVRE_TRACE("") From LECFIC 

Gosub defvar From wjsohstd : # Appel programme wrapper 
WW_ACTION = "READ" : # READ, CREATE, MODIFY, DELETE 
ww_ident = "NOR1204TOU0oooi" : # Cle de l'objet Vall~Val2 

Gosub webserv From wjsohstd : # Simulation web service 
Gosub ANALRESOBJ From WJSOHSTD : # Affichage du Statut 
Gosub detailres From wjsohstd : # Affichage des champs 
Call FERME_TRACE From LECFIC 
Call LEC_TRACE From LECFIC 
End 
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X>r DEMOFRA AdonixX3 - [Lecture fichier de tr 


■ j Fichier Edition Outils Options Affichage 

□ 


M 

◄ 

► 

►1 



<X> 

^ m\ 

1 *01 



2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 


25/02/06 10:17:12 (ADMIN) 


Lecture NOR1204TOU00001 : OK 

Nombre de messages 0 
Liste des messages 


18 


TO_MODST AMP : 

TO_MODUSER : 

SOHNUM_A : NOR1204TOU00001 
REVNUM_A : 0 
SOHTYP_A : NOR 
SALFCY_A : TOU 
CUSORDREF_A : 375/09 
ORDDAT_A : 29/12/2004 
BPCORD A : PHAR001 




































4.4.2 Test avec I'applicatif 


Test creation objet 


Trace du resultat 


########### 

## Test de creation 

########### 

Call TEST 
End 


Subprog TEST 

Local Char TEXTE(20) 

Local Integer I , J , K 

Call OUVRE_TRACE("") From LECFIC 

Gosub DEFVAR From WJSOHSTD 

WW_ACTION = "READ" :# On commence par lire 
WW_IDENT = "NOR1204TOU00001" : # Cle de 1'objet 

Vall~Val2 

Gosub WEBSERV From WJSOHSTD : # Simulation lecture 
WW_ACTION = "CREATE" : # Maintenant on cree 

Gosub WEBSERV From WJSOHSTD : # Creation 
Gosub ANALRESOBJ From WJSOHSTD : # Analyse du resultat 
Gosub DETAILRES From WJSOHSTD : # Affichage des champs 
Call FERME_TRACE From LECFIC 
Call LEC_TRACE From LECFIC 
End 


X)' DEMOFRA Adonix X3 - [Lecture fichier de trace FI 844] 


Outils Options Affichage ? 


uj 1 Fichier Edition 

□ n i^ i m m * mi ^ ^ ^ e si m i 


25/02/0G 10:29:35 (ADMIN) 


PF-001 


-1796,53 */* Marge inferieure a marge mini, de 
Code retour global 1 (OK) 

Creation NOR1204TOU00001 : OK 

Nombre de messages 2 

Liste des messages 


1 2 (Avertissement) : Cette reference existe deja pour ce client ! 

2 1 (Message) : Centre de Distribution 


TO_M0DST AMP 
UU_MODUSER : 
S0HNUM_A 
REVNUM_A 
S0HTYP_A 
SAIFCY A 


NOR1204TOU00010 

0 

NOR 

TOU 
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4.4.2 Test avec I'applicatif 


Test de sous programme 


■Dans le programme wrapper un sous-programme de test est integre. 


■Ce sous-programme appelle une etiquette INITWS avant I'appel du 
sous-programme et une etiquette RESULTWS apres I'appel 


■Ceci permet a I'interieur meme du programme a publier de prevoir des 
sequences de test (elles ne seront appelees que par le programme de 
test integre avec le wrapper) afin : 

■ De charger des variables avant I'appel, 

■ D'ecrire des resultats dans la trace apres I'appel 

■ L'ecriture des messages est geree automatiquement par le 
programme de test. 
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Test de sous programme 


Subprog STOCK ( ITEM, STO, SITE ) 

Variable Char ITEM 
Variable Decimal STO 
Variable Char SITE 

Local File ITMMVT [ITV] 

Local File ITMMASTER [ITM] 

Read [F:ITM]ITM0=ITEM 
If fstat 

Call ADDMESSWARN("Article inexistant.") From AWEB 
Else 


STO=0 

For [ITV] Where ITMREF=ITEM and STOFCY=SITE 
STO+=[ITV]PHYSTO 
Next 
Endif 
End 


Trace du resultat 

(Run WRSTOCK ) 


$initws : # Etiquette pour les tests 
ITEM="CDl0" 

SITE ="ASN" 

STO=0 

Return 

$resultws : # Etiquette pour afficher le resulat 
Call ECR_TRACE("ITEM="-ITEM,0) From GESECRAN 
Call ECR_TRACE("SITE="-SITE,0) From GESECRAN 
Call ECR_TRACE("STO="-num$(STO),0) From GESECRAN 
Return 


Code retour global : 1 (OK) 
Nombre de messages : 1 

Liste des messages 


1 2 (Avertissement) : Article inexistant. 


ITEM= CD10 
SITE= ASN 
ST0= 0 

Fin normale de trace 25/02/06 10:58:35 
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4.4.3 Test avec le serveur WEB 


■ Le serveur WEB inclus un testeur de web service, celui ci permet de valider le 
fonctionnement des objets modelises dans X3. 


11 s'agit d'un client web service, il accessible depuis la page technique 


1 3 Serveur Adonix X3Web - Microsoft Internet Explorer 


Fichier Edition Affichage Favoris Outils J 


^ Precedente - X | | jS*] y Rechercher 

Favoris ■» 

Adresse |£| http ://localhost:l 898/root/index, jsp 



Home 


Serveur de Serveur de web 
cache services 


Services 

Utilitaires 

• Testeur de WebServices 

Trace 

• Activite du serveur 

• Reolaoes 

• Acces aux fichiers 


Testeur des WebServices - Contexte 



Contexte 


Sous l)i o<li .1111 


Le contexte d'appel des Web Service a ete modifie. 


identification 


ADMIN 


Groupe d'entrees du pool DEMO_P 
Code utilisateur Adonix 
| Mot de passe Adonix 
| Code langue 


FRA frangais v 


Action © 


Memorisation du contexte 


l'/» M#nv#a W 'anna t si ■■ \Afrth CnnnVn 


Saisie des parametres de connexion 


Memorisation du contexte 
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4.4.3 Test avec le serveur WEB 


] http://localhost: 1898/root/index.jsp 

Serveur de Serveur de web 

Dime 

cache services 

testeur de web 

services 

Serveur de Serveur de Serveur Serv 

terminauK workflow d'edition ses 


Testeur des WebServices 


Choix du web service 



Services 

s 

jr de WebServices 

e du serveur 

2Si 

aux fichiers 


Testeur des WebServices - Objet 


Contexte 


Sous proaumme 


Liste 


Objet 


l 


Web service 

Iderrtifiant public 

Cle(s) 


Choix de 1’objet 


Choix de la methode 
invoquee 


Choix 



| Lecture j 


Suppression Action... | Description du WebService 


Resu ft at du sous programme 

Description de la reponse ® ™ 
Reponse XML O ® 
Rapport de traitement des donnees XML® ® 


* Information sur 1’execution de la methode 

< -Reponse XML du serveur web 

Trace de T execution de la methode invoquee 


Trace de la requete® ™ 

Donnees du sous programme < = 

Donnees XML ® 


Donnees XML transmises au serveur 






































































4.4.4 Le testeur JAVA 
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4.4.4 Le testeur JAVA 


■ Le testeur java est un outil de validation technologique muni d'une interface 
de controle et de saisie, il permet de s'affranchir dans un premier temps de la 
problematique de constitution des flux XML. 

■II est fourni a titre d'exemple et ne fait pas parti des livrables de la solution 
Sage X3 

Cet outil, 

■ I mplemente les trois web service (Objet / liste / s/s programme) 

■ Affiche les traces d'execution 

■ Affiche les flux XML de la reponse 

■ Donne les temps d'execution 

■ Construit les flux XML automatiquement 

■ I mplemente un outil de test de charge 

II utilise le fichier Def.Xml contenant les parametres de 
base pour acceder aux WEB services X3 
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4.4.4 Le testeur JAVA 


■ L'onglet trace et message d'erreur donne des informations sur I'execution du web 


service invoque 


Testeur WebService X3 


Fichier Aide 

Configuration [' Trace et messages d’erreur ( Objet SOH SOH 


000170 End execServerAction 
000170 End exec 

000170 Status=[0-KO] NbMess=[1] HasResult=[false] loadWebsl 
-1] poolRequestDuration=[-1] totaIDuration=[167,622] switchUser 
pen=[false] poolEntryldx= [0] rowlnDistribStack= [0] nbDistributionC 

-hasReport=[*Calling Object Alias[SOH] ObjectjSOH] FolderjC 

- NbErrors[3] NbWarnings|7] 

- [Comments] 

- Load parameters table OK - NbParameters=152- NbBlobs: 

- Parse XML parameter string OK-XMLSize=10340 chars. 

- Load input data KO - NbSetValue=[246] 

- "Load input data 

- NbErrors[3] NbWarnings[7] 

- [Err]Field[ADB1 _1 BPRNAM] Data size overflow. Type[Cha 

- [Err]Field[ADB2_1 .BPRNAM], Data size overflow. Type[Cha 

- [Err]Field[ADB3_1 BPRNAM], Data size overflow. Type[Cha 

- (Warning]Value already set. Field[SOH1_3.REP] Rank[2] O 

- [Warning]Value already set. Field[ADB1_1 BPRNAM] Rank| 

- [Warnlng]Value already set. Field[ADB1_1 BPAADDLIG] Rs 

- [WarningJValue already set. Field[ADB2_1 BPRNAM] Rank| 

- [Warning]Value already set. Field[ADB2_1 BPAADDLIG] Rs 

- [WarningJValue already set. Field[ADB3_1 BPRNAM] Rank| 

- [WarningJValue already set. Field[ADB3_1 BPAADDLIG] Rs 

- ) 

- Message_0=[type=[BLOK] message=[ll est impossible de c 

onsultez le rapport du chargement.]] 


************ Erreur ************ 
Modification en cours sur un autre poste 

MessagesX3: 

Modification avec avenant ? (Non) 
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Dans cet onglet on peut: 


■ Afficher la trace du serveur web 


■ Afficher le flux renvoye par le serveur 


■ Affiche les flux XML de la reponse 


■ Avoir des informations sur les temps 

■ Afficher la trace 


■ Sauver ces informations sur disque 





































































4.4.4 Le testeur JAVA 


Testeur Web service OB JET 


N° 

Code de I’objet 

Genere 

1 

SOH 

Oui 


Ajouter une ligne 


Supprimer la derniere ligne 


Generer les ecrans 


■ La generation des ecrans 
appelle le web service 
getdescription et ajoute un 
onglet dans I'interface 


Testeur WebService X3 


Fichier Aide 


Configuration Trace et messages d’erreur ObjetSOHSOH 


kkkkkkkkkkkk [jfJQIJf ************ 

Modification en cours sur un autre poste 


■ L'interface permet 
d'invoquer les autres web 
se vices 
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Testeur WebService X3 


Fichier Aide 




Configuration Trace et messages d'erreur ObjetSOHSOH 


Groupe SOHO_1 


Groupe SOH1_1 


Lire Creer Modifier Supprimer Valorisation Effacer Fermer 


Numero (SOHNUM) 

( REVNUM) 

( SOHTYP ) NOR 1 

Site vente (SALFCY) tou 

Reference (CUSORDREF ) 375/09 
Date (ORDDAT) 

Client cde (BPCORD) 

(BPCNAM) 

Devise (CUR) EUR 




Centre 


Client facture(BPCINV) 


PHAR001 



















































































4.4.5 Debugger les web service 

r Servo in A do nix X i Web 


Fichier Edition Affichage Fa ■ Pour debugger en mode web service il faut utiliser le debugger java 


© Precedente * ) 

Adresse c£j http://localhost: 1898/ 


11 est a telecharger depuis le serveur web 
Puis a lancer 



Home 


Serveur di 

cache 




Services 
Informations 

• A propos... 

• Administration 

• Serveurs 

Outils 

• Deboaueur L4G 

• Serveur de trace 

Trace 

• Activite du serveur 

• Realaaes 

• Acces aux fichiers 

Tomcat 

• Documentation 


Debogueur Adonix X3 


Lancement du debogueur... 

r Debogueur X3: - 

Lance le debogueur X3 avec I'outillage 'Sun Java Web Start' installe sur votre poste. 
Url du fichier de description de I'application: /X3DEBUGGER/debugger.jsp 



•d. 

Adonix Debugger version=[X3WebHead - 14w] build num=[14w-2006,01,04-10:50:26 

] HMD® 

File Edit Context Test Help 


Add Var Rm. Var Add BreakP. Rm. BreakP. Open source Step in Step over 

Run Save "MEMO" & Run Run & Debug Off 

l 

X3 Variables 
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4.4.5 Debugger les web service 


■ Une fois le debugger lance il faut invoquer 
connexion : 


Testeur WebService X3 


Fichier Aide 

Configuration Trace et messages d’erreur ObjetSOHSOH 


Parametres de connexion 


Langne 

User 

Password 

Pool 

Server 


FRA 


ADMIN 


DEMO P 


localhost:80 


Parametres avances 


Activation trace du web service 
Taille maxi de la trace web 
Trace du serveur X3 
Niveau de trace X3 
Taille maxi de la trace X3 
Activation du debugger X3 
Nom du serveur du debuggei 
Numero du port du debugger' 


on 


16384 


on 



un web service en precisant dans la chaine de 

■ Le nom du serveur du debugger 

■ Le numero de port ( defaut 1789 ) 




AdonixDebugger version=[X3WebHead - 14w] build num=[14w-2006,01,04-10: 


File Edit Context Test Help 


i 


Add Var Rtn. Var Add BreakP. Rm. BreakP. Open source Step in Step over 


AWEB 


964 D1=instr(1 ,AWBS,TIM-") 

955 If D1 <>0 

956 D2=instr(D1 +5,AWBS 1 "1 

957 H0RDAT1=mid$(AWBS,D1 +5.D2-D1-5) 

958 Break 1 

959 Endif 

960 Wend 

961 Openi Using [XMLJ 

962 

963 If H0RDAT<»"" and HORDAT1 <>H0RDAT: OK=9 : Endif 

964 H0RDAT=H0RDAT1 

965 

966 End 

967 

968 

969 $ISDBGON 

970 Local Char WPTRACE(250)(1 ..2),TSTART 

971 TSTART=num$(time) 

972 Setlob WPTRACE(1 ..2) With WW_TRACE 

973 If instr(1,WPTRACE(1),"adonix debug.on=on")=0 : Gosub ISSESVALID : Return: Endif 

974 lfdim(MGIAADXC7X)<0 : Global Char GIAADXCTX(250): Endif 

975 MGIAADXCTX=WPTRACE(1) 

976 Dbgaff 

977 Gosub ISSESVALID 



Current Source=[ AWEB - X31 Line 


■ Le debuggeur s'arrete dans le traitement AWEB puis sur chacun des dbgaff 

sj oufeesodargis lesioodearge Businesses 
























































































4.5 Les tests de charge 


■ Une fois la mise au point terminee, il faut verifier la performance globale du 
systeme web service. Cela implique d'avoir au depart des informations sur le 
nombre maximum de requete envoyee sur le serveur WEB X3. II faut se 
concentrer sur les pics d'activite du site web par exemple. 

■ II faut savoir qu'une creation d 'enregistrements par le biais du web service 
objet est moins rapide qu'un import, 

■ Les tests de charge permettent aussi de determiner le nombre de licence 
necessaire pour avoir des temps de reponse acceptable. 

■ Ils permettent d'avoir une idee de la charge CPU et de la consommation 
memoire sur le serveur web et sur le serveur X3. Le parsing des fichiers XML 
est consommateur de ressources. 

■ Les tests de charge peuvent etre realises par le testeur JAVA qui permet de 
simuler une activite utilisateur en fonction d'un scenario donne et pour nombre 
simultane d'utilisateur parametre. 
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4.5 Les tests de charge 



Fichier Aide 


Configuration Trace et messages d'erreur Objet SOH SOH Scenario Creation d'enregistrements 


l 


Nom public de 1’objet : Nom de publication dans X3 
Flux modele : flux xml envoye au serveur 
Champ cle : Nom du champ cle de V objet 
Nombre de thread : Nombre d’utilisateurs simultanes 
Nombre maxi de requete : Nombre de demande pour 
chaque utilisateur ( envoyee sequentiellement) 
Interval de temps : Temps d’attente entre chaque 
utilisateur supplementaire 

Duree minimum : Duree au dela de quelle le test se 
termine automatiquement 

Repertoire des fichiers log : Repertoire disque ou sera 
mis le fichier du resultat 


Commande du scenario 


Lancement Information Fenner 


Parametres du scenario 


Parametres du lanceur- 

Nombre de thread 

Nombre de requete maximum par thread 


Nom public de I'objet 
Flux modele 
Champ cle 


OBJSOH 


<PARAM><GRP ID= 


SOHNUM 


10 


50 


Interval de temps entre chaque thread (sec) ] 
Duree maximum du test (min) 

Repertoire des fichiers log 


AErr 


Information sur le deroulement du scenario 


Effacer 





































































4.5 Les tests de charge 
Le res u I tat 


L'execution du stresseur produit un fichier csv exploitable sous excel 


s- C^uAVA\+ Data\ja r\e r r 



Fichier Edition AfFichege Favori 
Precedente T 

Adresse 


Nor n 

Result. csv 
© Iog005.txt 
m Iog004. txt 
f|D Iog003.txt 
f|D Iog002.txt 
f pli logOO 1 . txt 


E2 Microsoft Excel - Result.csv 


Fichier Edition 

Affichage Insertion Format Outils Donnees Fenetre ? 

□ 

y S 

m ^ ^ ^ a ii 



F20 - 

= 




-r 

A 

B 

C 

D 


i 

Process 

N° 

Info 

Error 

TO 

2 

1 

1 

EXEC STOCKSITE 

□ 

11408 

3 

1 

2 

EXEC STOCKSITE 

□ 

11408 

4 

1 

3 

EXEC STOCKSITE 

□ 

11408 

5 

2 

1 

EXEC STOCKSITE 

□ 

11408 

6 

2 

2 

EXEC STOCKSITE 

□ 

11408 

7 

2 

3 

EXEC STOCKSITE 

O 

11408 

8 

3 

1 

EXEC STOCKSITE 

O 

11408 

9 

3 

2 

EXEC STOCKSITE 

□ 

11408 

10 

3 

3 

EXEC STOCKSITE 

□ 

11408 

1 1 

4 

1 

EXEC STOCKSITE 

□ 

11408 

12 

4 

2 

EXEC STOCKSITE 

□ 

11408 

13 

4 

3 

EXEC STOCKSITE 

□ 

11408 

14 

5 

1 

EXEC STOCKSITE 

□ 

11408 

15 

5 

2 

EXEC STOCKSITE 

□ 

11408 

16 

5 

3 

EXEC STOCKSITE 

□ 

11408 

1 7 







Process : Numero de l'utilisateur 


rowInDistribStack : Rang d’empilage dans la file d’attente a l’arrivee de la requete 


N° : Numero de la requete pour un utilisateur nbDistributionCycle : Nombre de test effectue avant de trouver une connexion 

disponible 


Info : Indique l'objet du web service 
Error : Si = 1 une erreur s'est produite 
TO : Time stamp de la demande 
T1 : Time stamp de la reponse 
T1-T0 : Temps d'attende 


poolEntryldx : N° de l’entree dans le pool de connexion 
poolDistribDuration : Temps de recherche d’une connexion libre 
poolExecDuration : Temps d’execution du traitement ADONIX 
poolWaitDuration : Temps d’attente de la requete avant d’etre en tete de la liste d’attente 
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Mise en oeuvre des WEB service X3 


Resume 


Pour utiliser les services WEB X3 il faut: 

■ Installer et configurer le serveur WEB X3 

- Rapide et simple a faire peu de parametres a renseigner tout est 
automatique 

■ Developper en L4G les sous programmes 

- A faire uniquement si la tache a realiser n'est pas modelisee sous 
forme d'objet 

■ Publier les objets et les sous programmes concernes 

- II faut decrire au prealable les sous programme dans le dictionnaire 

- C'est une operation tres rapide a realiser 

■ S'assurer de leur compatibilite dans ce mode d'utilisation 

- Sur I'objet des commandes de vente rien est a faire 

- Pour les autres objets, seul des tests peuvent donner une idee du 
travail a accomplir, notamment en ce qui concerne le specifique 
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Mise en oeuvre des WEB service X3 


Les evolutions prevues pour la release V5.1 


Les appels de Web service SOAP 

Architecture: 

-Les appels de Web service SOAP sont realises via le composant "Sage X3 J ava Server" 
-L'outillage d'appel de Web services SOAP est un "plugin" de ce composant 

Le plugin d'appel des Web services SOAP : 

-II utilise le clients de Web Service Apache Axis2 en version 1.2 ( http://ws.apache.org/axis2/ ) 

-Ce client respecte les specifications : 

^"WS-I" (voir http://www.ws-i.org/ et http://fr.wikipedia.org/wiki/WS-l ), 

^"WS-Security" ( http://www.oasis-open.org/committees/tc home.php?wq abbrev=wss ) 

-Les Web services tiers pouvant etre appeles sont done ceux qui respectent les specifications 
"WS-I Basic Profile" et "WS-Security" 
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Mise en oeuvre des WEB service X3 


Les evolutions prevues pour la release V5.1 


Les appels de Web service SOAP 

Depuis le L4G X3, le mode operatoire d'un appel est: 

-Ouverture d'une session avec un serveur "Sage 3 J ava Server" (cf. Opadxd ) 

-Un appel pour obtenir une reference sur une instance du stub du Web service tiers a 
appeler 

-Un ou des appels pour creer le ou les "java beans" (cf. structures) correspondant 
au(x) parametre(s) necessaire a I'action du Web service tiers 

-Appel de la methode du stub correspondant a Taction du Web service tiers a appeler 

-Un ou des appels pour lire le ou les "java beans" (cf. structures) correspondant au(x) 
valeurs(s) retournees du Web service tiers (ex: un arbre...) . 
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Mise en oeuvre des WEB service X3 


Les evolutions prevues pour la release V5.1 


Les appels de Web service REST 

Architecture: 

-Les appels de Web service SOAP sont realises via le composant "Sage X3 J ava 
Server" 

-L'outillage d'appel de Web services REST est un "plugin" de ce composant 

Le plugin d'appel des Web services REST : 

-I I utilise le clients HTTP produit par le sous projet «Apache J akarta 
HttpComponents » http://iakarta.apache.orq/httpcomponents/index. html 

^Standards based, pure Java, implementation of HTTP versions 1.0 and 1.1 
^Full implementation of all HTTP methods (GET, POST, PUT, DELETE, HEAD, 
OPTIONS, and TRACE) in an extensible OO framework. 

^Supports encryption with HTTPS (HTTP over SSL) protocol. 

^Transparent connections through HTTP proxies. 

^Tunneled HTTPS connections through HTTP proxies, via the CONNECT method. 
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Mise en oeuvre des WEB service X3 


Les evolutions prevues pour la release V5.1 


Les appels de Web service REST 

Depuis le L4G X3, le mode operatoire d'un appel est: 

-Ouverture d'une session avec un serveur "Sage 3 J ava Server" 
-(nouvelle instruction Opadxd ) 

-Un appel pour obtenir une reference sur une instance du client HTTP 
-Un ou des appels pour configurer cette instance (mime type attendu, ...) 
-Appel de la methode GET, POST, PUT, DELETE de I'instance 
-Un ou des appels pour lire les donnees (xml, json, etc...) delivrees par le 
Web Sen/ice tiers. 
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Travaux pratiques 


Exercice 1 


(voir annexe) 

■ Publication et tests sur les web services 

- Objet 

- Liste 

- Sous programmes 


■ Test de ces objets pour chacune des methodes 
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Formation Web Services Adonix 


5. Integration dans Implication cliente 

5.1. Flux XML regu 

5.2. Flux XML emis 

5.3. Application cliente en JAVA 

5.4. Application cliente DOTNET 




5 Integration dans I'application cliente 


■ L'objectif est d'invoquer les web service X3 depuis une application 
tierce. 

■ Le standard web service comporte une norme qui decrit le service WEB, 
il se presente sous la forme d'un fichier XML. Ce fichier (*.wsdl) decrit 
les methodes et les proprietes fournies par le service. 

■ Mais dans le contexte ou I'application serveur est un ERP qui n'est pas 
fige dans sa structure il n'est pas possible de fournir un service web 
immuable. 

■ Pour ne pas avoir a modifier les applications clientes parce qu'on a 
ajoute un champ dans un ecran, nous proposons des services web 
generiques ou seules les methodes sont fixes. 

■ La partie variante est constitute des parametres a transmettre a ces 
methodes. Ceux - ci sont transmis via un flux XML qui est a coder et a 
decoder dans les applications clientes. 

■ De nombreuses librairies sont disponibles dans differents langages pour 
effectuer ce travail. 
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5 Integration dans I'application cliente 


■ Le serveur web 14W31 incorpore plusieurs versions des web services X3, ceux-ci 
sont presentes dans un tableau sur le serveur web : 



Serveur de 

cache 


Serveur de web 

services 


. Serveur de WebSer 


Services 


Les WebServ 


Utilitaires 

• Pools de connexions 

• Cache des descriptions 


Trace 


CAdxObjectXml (wsdi) 
CAdxObjectListXml (w 
CAdxSubProgramXml 


• Activite du serveur 

• Reglaoes 

• Acces aux fichiers 


Ces services necessitenl 
place d'un SOAPElement 
d'identification dans le h 
massanR Snan. 


Le tableau croise la version du web 
service avec les plate formes client 
qui vont les utiliser 

Java : les exemples sont fournis 
sous la forme d'un workspace 
Eclipse 3.1 

Dot NET : les exemples sont fournis 
sous la forme d'une solution visual 
studio 2003 ou 2005 


Chaque version a ses avantages et inconvenients 
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5 Integration dans ('application cliente 


Les WebServices 

CAdxObjectXml ( wsdl ). 

CAdxObjectListXml ( wsdl ). 

C AdxSubProgramXml ( wsdl ) 


JAVA 


.NET 


Classe generees .i partir des wsdl ( ce qui 
evite de les geneiei soi-meme > 


Ancienne version web service 14W20, 
3 webs services distincts, la 
compatibility ascendante est 
assuree. II necessite une 
connaissance de SOAP pour ajouter 
le header manquant. 


Les classes stub 
Les sources des classes stubs 




DLL pour utiliser ce web service dans dot 
Net et son source 


Exemple en Java livie sous la forme d'un 
piojet Eclipse < enviionnement de 
developpement) 


Le workspace Eclipse 3.1 




L'assemblv dans un CAB siqnee, 


L'assemblv utilisable dans un proiet Visual 

Studio 



Exemple pour utiliser ces web 
.HET 


La solution Visual Studio 2003 


services en I 


-i- 


CAdxWebServiceXmlCC ( wsdl ). 

Ilouvelle version du web seivice. le 
header a ete r emplace, plus facile a 
utiliser. II n*y a plus q'un WSDL 


Exemple en Java livre sous la forme d'un 
projet Eclipse, les classes generees sont 
indues dans le piojet. 


e workspace Eclipse 3.1 


Exemple .NET 2005 poui utiliser 
directement ce web service done sans la 
DLL qui n'est plus utile ici. On est plus 
pioche du standaid web seivice. 


La solution Visual Studio 2005 


CAdxWebServiceDomCC ( wsdl ). 


Identique au web service precedent 
mais les informations sont 
lecuperees sous la for me d’un aibie 
XML dii ectement en memoii e, plus 
de parsing a realise! 


En java ce web service lie peut pas etre 
utilise dans une application cliente. Piobleme 
de compatibility... 


Exemple .NET poui utiliser ce web sercice, 
fourni sous la forme d'une solution .net 
2005. 


La solution Visual Studio 2005 
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5.1 Flux XML regu 


■ On obtient un flux resultat suite a : 

- Lecture d'un objet 

- Modification ou creation d'un objet 

- Suppression d'un objet 

- Execution d'une option 

- Execution d'une liste gauche 

- Execution d'un sous programme 


■ Le flux est compris dans un noeud RESULT 

< RESULT > 

</RESULT > 
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5.1 Flux XML re£U 


■ Dans le flux on peut recevoir : 

- Des groupes de champs ( bloc liste ou parametre de sous 
programme) 

<GRP 

ID = "ITM0_1"> 

</GRP> 

- Des tableaux de champs ( bloc tableau ) size donne le nb de lignes 

<TAB DIM = "4" ID = "ITM5_2" SIZE = "4"> 

</TAB> 

- Les tableaux contiennent des lignes, num donne le numero de la ligne 

<LIN NUM = "3"> 

</LIN> 


102 © 2006/2007 Sage - Midsize And Large Businesses 





5.1 Flux XML regu 


■ Dans les noeuds GRP et LIN on peut avoir : 

- Des champs simples 

<FLD NAME="ITMREF" TYPE="Char">CD100 </FLD> 

- Des champs de type menu local, MENULAB contient 
I'intitule du menu 

<FLD MENULAB="Actif" MENUL0CAL="246" NAME = "ITMSTA" 
TYPE="Integer" > 1 </FLD > 

■ Dans les noeuds GRP on peut avoir aussi : 

- Des champs dimensionnes : 

<LST NAME="TSICOD" SIZE = "1" TYPE="Char"> 
<ITM>JOU</ITM> (lere occurrence) 

<ITMx/ITM> (2nd occurrence) 
<ITM>ECR</ITM> (3eme occurrence) 

</LST > 
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gyp 




5.1 Flux XML regu 


■ Pour un sous programme on a : 

- Des champs simples si la dimension = 1 

- Un ou plusieurs tableaux regroupes en cardinality homogene 


■ Pour une liste gauche on a un seul tableau 
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5.2 Flux XML envoye 


■ On doit transmettre un flux pour 

- Creer un objet 

- Modifier un objet 

- Executer un sous programme 

■ Le flux est compris dans un noeud PARAM 

<PARAM> 

</PARAM> 

■ Le flux a transmettre est identique au flux re^u, mais il peut etre 
plus souple : 

- Si le champ peut etre identifie sans ambiguite, il n'a pas besoin 
d'etre dans un noeud groupe 

- Les types de donnees ne sont pas a preciser 

- Les intitules des menus locaux sont inutiles 

- Seuls les champs modifies sont a transmettre 

- Indiquer le nombre de lignes des tableaux est facultatif 

- Indiquer pour chaque ligne d'un tableau son numero est facultatif 
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5.3 Application cliente en JAVA 
5.3.1 Preparation de I'environnement 


Les fichiers WSDI_ 

■ II existe un standard de description des web services, la description est stockee 
dans un fichier WSDL ( Web Service Description Langage ) 

■ Ce fichier donne des informations sur les methodes proposees par le service web 
ainsi qu'une description des parametres a passer pour les utiliser 

■ Sur le serveur WEB vous trouverez 3 fichiers WSDL aux URL suivantes : 

- Version 14W20 : 

✓ http://webserver/adxwsvc/services/CAdxSubProqramXml?wsdl 

✓ http://webserver/adxwsvc/services/CAdxObietctXml?wsdl 

✓ http://webserver/adxwsvc/services/CAdxObiectListXml?wsdl 

- A partir de la version 14W31 

✓ http://webserver/adxwsvc/services/CAdxWebServiceXmlCC?wsdl 

■ Dans une application cliente java ou .NET ces fichiers peuvent etre directement 
utilises pour generer le code java permettant I'appel aux web services respectifs 
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////////// 


5.3 Application cliente en JAVA 


Preparation de I'environnement _ 

Solution 1 : integration du WSDL et generation des classes stubs 


Serveur de web service 




Plate forme de 
developpement J ava 


Site de telechargement 


L 


@ 



Recuperation du fichier WSDL Telechargement des packages ANT 

etAXIS 


x http://webserver/adxwsvc/services/CAdxWebServiceXmlCC?wsdl 


Norn - A - 

▼ ^icAdxMessage. java j 

^ , 1 1 1 M CAdxObiectListXnil.iava 

Generation des classes stubs MjcAdxobjectustxmiservice.java 

Ml CAdxObjectListXmlServiceLocator. java 
Ml CAdxObjectListXmlSoapBindingStub. java 
M CAdxObjectXml. java 
Ml CAdxObjectXmlService. java 
Ml CAdxObjectXmlServiceLocator. java 
► Ml CAdxObjectXmlSoapBindingStub.java 
M| CAdxParamKey Value, java 
Ml CAdxResultXml. java 
Ml CAdxSubProgramXml. java 
Ml CAdxSubProgramXmlSer vice, java 
M CAdxSubProgramXmlSer viceLocator .java 
M C AdxSubProgramXmlSoapBindingStub. java 
Ml CAdxT echnicallnf os, java 

05 
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5.3 Application cliente en JAVA 


Preparation de I'environnement 


Solution 2: telechargement des classes stubs depuis le serveur WEB 

Serveur de web service Plate forme de developpement J ava ^' te telechargement 



) <- 


Recuperation des classes stubs 


Java 


kn Mmniiwi 


Telechargement des packages AXIS 


Home 


Serveur de 

cache 


Serveur de web 

services 


testeur de web 

services 


Serveur de 

terminaux 


Serveur de 

workflow 


Serveur de WebServices 


Services 

Utilitaires 

• Pools de connexions 

• Cache des descriptions 

«J r •-fiir.,'iiir i , r 

^ Les stubs pour axi 

Trace 

• Activite du serveur 

• Reolaoes 

• Acces aux fichiers 


Les WebServices 

CAdxObjectXml ( wsdH . 

CAdxObjectListXml ( wsdl ). 

CAdxSubProgramXml (wsdl) 

Ces services necessitent la mise en 
place d'un SOAPElement 
d'identification dans le header du 
message Soap. 


JAVA 


Les classes Java generees avec I'utilitaire 
"wsdl2java" d' Apache Axis 1.4 

Les classes stub 


es sources des classes stubs: 


Le projet "AdxWebServices_header_tester" 
illustre I'usage des classes stub et des 
methode de I'outillage Axis pour envoyer le 
SOAPElement d'identification : 
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5.3 Application cliente en JAVA 


Preparation de I'environnement 


■ L'objectif est de constituer un flux SOAP qui soit conforme a ce que le serveur web 
attend, c'est a dire conforme a la description donnee dans le fichier wsdl, Les etapes 
pour y parvenir sont les suivantes ; 

1. Chaque methode appelee doit contenir un contexte d'appel, c'est I'un des 
parametres de la methode, il contient les informations suivantes : 

^ Code langue X3 
^ Code utilisateur X3 
^ Mot de passe X3 

^ Pool de connexion : il s'agit de I'alias donne dans la console 

^ Serveur web : nom et port (80 ou 1898 par defaut) du serveur web X3 

^ Chaine de configuration : indique les differents niveaux de trace pour la mise au point 

2. Les methodes appelee necessitent des parametres supplemental res. Ceux-ci sont regroupes 
dans un parametre unique qui contient en realite I'ensemble des parametres d'un sous 
programme ou I'ensemble des champs d'un objet. 

^ Ce parametre est a construire manuellement dans I'application cliente, il doit se presenter 
sous la forme d'un flux XML 

3. Une fois la methode executee, celle - ci retourne des parametres, ceux - ci sont regroupes en 
un seul. 

^ Ce parametre est a decoder, il est presente sous la forme d'un flux XML qu'il faudra parser 
pour recuperer les informations 
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5.3 Application cliente en JAVA 


Import des packages 


/* Packages utilises pour parser les flux XML */ 

import java.io.StringReader; 
import javax.xml.parsers.DocumentBuilder; 
import javax.xml.parsers.DocumentBuilderFactory; 
import org.xml.sax.InputSource; 

/* Packages utilises pour manipuler le flux xml */ 

import org.w3c.dom.Document; 
import org.w3c.dom.NamedNodeMap; 
import org.w3c.dom.Node; 
import org.w3c.dom.NodeList; 

/* Classes generees pour appeler le web service */ 

import com.adonix.wsvc.stubs.CAdxWebServiceXmlCCServiceLocator; 
import com.adonix.wsvc.stubs.CAdxWebServiceXmlCC; 

import com.adonix.wsvc.stubs.CAdxResultXml;// Classe generee contenant la reponse du serveur 
de web service 

import com.adonix.wsvc.stubs.CAdxMessage; // Classe generee pour lire les messages retournes 
par l’applicatif 
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5.3 Application cliente en JAVA 


La requete de configuration 


■ II s'agit d'une chaine de caracteres qui fait partie du header a 

transmettre dans le flux SOAP, chaque para metre est separe par «&» 


■ Elle est constitute des elements suivants : 

- adxwss.trace.on = (on/off ) : active la trace du serveur WEB 

adxwss.trace.size=16384 : tai I le maximum de la trace (ne pas 
changer) 

- adonix.trace.on = (on/off) : active la trace du serveur X3 

adonix.trace.level = (l/2/3) : niveau de trace (parametre en entree, 
sortie, E/S ) 

adonix.trace.size=8 : taille maximum de la trace (taille du clob, ne 
pas changer) 

- adonix.debug.on = (on/off) : activation du debugger 

adonix.debug.host=localhost : machine ou est lance le debugger 

- adonix.debug.port=1789 : port du debugger 
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5.3 Application cliente en JAVA 


La requete de configuration 


■ Deux fagons de proceder 

- Fabrication d'une chatne de caracteres en dur : 

String RequestConfigDebug = " 

adxwss.trace.on=on&adxwss.trace.size=16384&adonix.trace.on=on&ado 
nix.traceJevel = 3&adonix.trace.size=8"; ou si pas de debug du tout : 

String RequestConfigDebug = " adxwss.trace.on=off&adonix.trace.on=off"; 

- La reconstruire a chaque appel pour activer la trace ou pas 
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5.3 Application cliente en JAVA 

Constitution du contexte d'appel 


■ L'objectif est de construire un para metre qui sera ajoute aux methodes 
appelees. Ce para metre est une classe (CAdxCallingContext) doit 
contenir les champs suivants : 

- Code langue, 

- code utilisateur, 

- mot de passe, 

- pool de connexion 

- et requete de configuration 

Code java correspondant : 

CAdxCallContext CallContext; 

CallContext = new 

CAdxCallContext(Lan,User,Pwd,Pool,RequestConfig); 

- Le CAdxCallContext est une des classes generees, elle stocke le 
contexte d'appel 
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5.3 Application cliente en JAVA 


Constitution du flux XML 


Deux fagons de proceder pour constituer le flux 
Exemple avec un flux pour demander le stock d'un article : 

- Fabrication d'une chaine de caracteres « en dur » 
String Parametre="<PARAM><GRP ID=\ ,, G1\ ,, XFLD ^ 

tem>} , </FLD></GRP></PARAM>"; 



Partie 

fixe 


NAME = \"ITEM\">" 

s Avantage : c'est simple a faire mais pas tres souple 

s Inconvenient : le code sera a reecrire pour chaque appel a 
des objets ou sous programmes differents. 


Partie 

variable 


- Construction manuelle d'un flux XML a I'aide des librairies DOM 
et parsing du flux pour obtenir une chaine de caracteres. 

^ Avantage : une fois le code ecrit il peut etre reutilise pour 
chaque flux a construire 

✓ Inconvenient : Plus complexe a mettre en oeuvre (parsing du 
flux XML) 
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5.3 Application cliente en JAVA 


Instanciation du web service 

■ L'objectif est de declarer et de preparer le web service en vue de son execution, 
pour cela deux etapes sont necessaires : 

- Declarer un «locator » ( url de destination ) 

- I nstancier le web service ( utilisation des classes stubs generees ) 

■ Exemple avec un sous programme : 

private CAdxUebServiceXmlCCServiceLocator Serv^^ de connexion 

private CAdxUebServiceXmlCC Service; //Le sous programme X3 

ServiceLocator = new CAdxUebServiceXmlCCServiceLocator(); 

// On indique 1 1 URL du web service) 

ServiceLocator . setC AdxUebServiceXrn 1CCEndpo int. Addres3 { 

"http://localhost:1893/adxwsvc/services/CAdxWebServiceXmlCC") ; 

// Instanciation de la c1asse stub c□ntenant 1es foncti□ns d 1 appel webservice 
Service = ServiceLocator . getCAdxljJebServiceXmlCC () ; 

■ Les classes Cadx... sont les classes generees (soit telechargees sur le serveur 
web, soit generees depuis le WSDL ) 
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5.3 Application cliente en JAVA 

I A\l>D 


el du web service 


■ Appel du web service : L'objectif est d'invoquer le web service, cela revient a 
envoyer une requete HTTP contenant le flux SOAP a destination du serveur 
web X3 


- Exemple avec d'appel d'un sous programme ( STOCK) : 


Declaration de la classe de retour pour stocker le resultat: 


private CAdxResultM X3Reply; // Reponse retournee par le serveur de ieb/s 


Appel du web service ( la requete http part a ce moment la ): 


X3Reply = Service. run(CallContext, "STOCK", 

1 J 1 .W\W.WvVvVvVvVvVvV-A r ' 


XML); 
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5.3 Application cliente en JAVA 


Decodage du resultat 


■ Lore du retour du web service le resultat est stocke dans une classe 
CadxResultXml qui permet de : 

- Recuperer le flux de la reponse ( c'est ici que x3 a mis le 
stock de notre article ) 

String Result = X3Reply.getResultXml(); 

- Recuperer le statut ( tout c'est bien passe ? ) 

Int Statut = X3Reply.getStatus(); 

- Recuperer les messages ( on recupere ici les messages 
applicatifs ) 

CAdxMessage[] Messages = X3Reply.getMessages(); 
for ( int i = 0; i<Messages.length; i + + ) 

System.out.println("Message " + i+" 
"+Messages[i].getMessage()); 

- Recuperer une structure avec les temps et les traces ( tres 
utile lors du debugage ) 

CadxTechicallnfo = X3Reply.getTechnicalInfos(); 
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5.4 Application ciiente en .NET 


Preparation de I'environnement 


■ Tout comme java il y a une etape d'integration de fichier WSDL, appele 
reference web en environnement dot NET. 


■ Les soucis d'interoperabilite entre le serveur axis et le client dot NET nous 
imposaient en 14W25, I'utilisation d'une dll qui contenait deja les classes 
stubs packagees pour etre directement utilisable dans un projet dot NET. 


■ Depuis la version 14W31 il est possible d'integrer dans un projet visual 
studio le fichier WSDL 


■ Lors de son integration les classes se generent automatiquement et sont 
directement utilisables. 
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5.4 Application cliente en .NET 


Preparation de I'environnement 


■ Nouveau projet visual studio 2003/ 2005, exemple avec une console en C# ... 


Service14W31 - Microsoft Visual C# .NET [design] - Classl .cs 

Fichier 

Edition Affichage Projet Generer 

Deboguer Outils Fenetre ? 

Nouveau ► 

i^p Ptojet... Ctrl+Maj+N 

Ouvrir ► 

^ Fichier... Ctrl+N 

Fermer 

Nouvelle solution... 

Vti| Ajouter un nouvel element.., Ctrl+Maj+A 

z. 

ITTT1 Ajouter un element existant,,, Maj+Alt+A 


Ajouter un projet ► 



Nouveau projet 


Types de projets : 


Modeles : 


Hppucacion weD hsk.i'jl i 

^Service Web ASP.NET 
JjT Application Web mobile A 

iBiyjgthgflusJgcontroles 


l_ | Proiets Visual Basic 
^ - ^^_Projet^Visual < C£ — ^> 

C3 Projets Visual J# 

Si CJ Pro jets Visual C++ 

I I Projets de configuration et de deployment 
Si Q Autres projets 

L3 Solutions Visual Studio 



~~ff1 Projet vide 

#5t Projet Web vide 

^Nouveau projet dans un 


Projet de creation d’une application en ligne de commande 


■ Puis integration d'une reference WEB ... 


rosoft Visual C tt .NET [design] - Classl .cs 


: de 


;ur 

)ii 


Projet Generer Deboguer Outils Fenetre ? 


jg) Ajouter un formulaire Windows... 
ilsl Ajouter un formulaire herjte... 
jdl Ajouter un controle utilisateur... 
jjl Ajouter un controle herite... 
m Ajouter un composant... 


Ajouter une reference. 


Ajouter une reference Web... 





% 

Ajouter une classe... 


'’ic 

tii 

Ajouter un nouvel element... 

Ctrl+Maj+A 

ir^ 

m 

Ajouter un element existant... 

Maj+Alt+A 

-Pt 


Exdure du projet 


lai 

JS 


Afficher tous [es fichiers 



iti 
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5.4 Application cliente en .NET 


Preparation de I'environnement 


■ Ajout du WSDL : 
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lication cliente en .NET 


Le developpement 


■ Exemple commente en C# : 

■ En rouge les classes stub ( generees ) 

■ En bleu les variables 

■ En vert les commentaires 

1. Declaration des name space utilises 


/* Classe de base */ 
using System; 

/* Classe des web service X3 */ 

using Servicel4W31.1ocalhost; // Le nom depend du nom de la reference web 


2. Declaration des variables utilisees 

CAdxWebServiceXmlCCService Subprog = new CAdxWebServiceXmlCCService(); // Le web service 
CAdxCallContext Context = new CAdxCallContext(); // Le contexte d’appel 
CAdxResultXml Resultat; // Le resultat de l’appel 
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5.4 Application cliente en .NET 


Le developpement 

3. Alimentation du contexte 

Context.codeLang=" FRA"; // Code langue X3 

Context. codeUser=" ADMIN"; // Code utilisateur X3 

Context.password=""; // Mot de passe” 

Context.poolAlias-'FORM"; // Pool de connexion 

Context.RequestConfig-' adxwss.trace.on=on"; // Requete de configuration 


4. Affectation de PURL de la requete 

H Ju5prog .Url = "http://localhost: 1898/adxwsvc/services/CAdxWebServiceXmlCC 

5. Appel de la methode webservice et recuperation du resultat 


Resultat = Subprog.run(Context, " ", 

"<PARAM> 

<GRP ID=\"G1\"> 

<FLD NAME=\"ITEM\">ECR01</FLD> 
<FLD NAME=\"SITE\">ASN</FLD> 

</GRP> 

</PARAM>"); 
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5.4 Application cliente en .NET 


Le developpement 


6. Recuperation des messages d'erreur 


Console.WriteLine("statut="+Resultat.status); // Statut general de retour 0=Ok 1 = KO 
for (int i=0; i<Resultat.messages.Length; i++) // Boucle pour recuperer les messages 
{ 

if (Resultat.messages[i].type.Equals( n r’)) Console.WriteLine('’INFORMATION : "); 
if (Resultat.messages[i].type.Equals("2")) Console.WriteLine("AVERTISSEMENT : "); 
if (Resultat.messages[i].type.Equals("3")) Console.WriteLine("ERREUR : "); 
Console.WriteLine(Resultat.messages[i].message); 


} 


7. Recuperation de la trace 

Console.WriteLine( ,, trace= ,, +Resultat.technicalInfos.traceRequest); 
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